A API da Kondado permite que você acople programaticamente a nossa plataforma ao seu stack de analytics, melhorando o entrosamento entre todas as etapas do seu ecossistema.
URL Base
A não ser que a documentação de algum endpoint especifique de outra forma, todas as chamadas deverão ser feitas com a seguinte URL base:
https://k2.kondado.com.br
Autenticação
Antes de começar com a nossa API, você precisará gerar tokens de acesso conforme este tutorial. Os tokens criados herdarão as permissões do usuário que os gerou e servirão para autenticar as suas chamadas de forma segura e facilmente revogável sem que você precise alterar sua senha.
O token será composto de 2 components: chave (identificação do token) e token ("senha" do token).
Em posse de chave e token, você deverá passá-los como parâmetros para a chamada da seguinte forma:
key: chave do token token: token
Exemplo de URL autenticada
https://k2.kondado.com.br/{endpoint}?key=chavedotoken&token=seutokenaqui
Limite de requisiçoes
A API possui 2 limites, aplicados por IP e por key:
- 1 requisição por segundo
- 20 requisições por minuto
Ao atingir estes limites, será retornado o erro abaixo (com código de status 200):
{
"success":false,
"error":"RATE_LIMIT_EXCEEDED",
"message":"Too many requests. Please try again in 60 seconds."
}
Começar a usar a API da Kondado
Passos essenciais para autenticar e realizar suas primeiras requisições na API da Kondado de forma segura e dentro dos limites estabelecidos.
Obtenha suas credenciais de API
Acesse o painel da Kondado e gere um token de acesso conforme o tutorial interno. Guarde a chave e o token gerados, pois eles herdarão suas permissões de usuário e servirão para autenticar todas as suas chamadas de forma segura e facilmente revogável.
Monte a URL base da requisição
Utilize a URL base https://k2.kondado.com.br para todas as suas chamadas, a menos que a documentação de algum endpoint específico indique outro endereço. Essa padronização garante que suas requisições cheguem aos servidores corretos da plataforma.
Adicione os parâmetros de autenticação
Inclua os parâmetros key (sua chave de identificação do token) e token (a "senha" do token) na query string da URL, seguindo o formato: ?key=chavedotoken&token=seutokenaqui. Essa combinação autentica sua requisição sem expor sua senha principal.
Respeite os limites de requisições
Mantenha suas chamadas dentro dos limites de 1 requisição por segundo e 20 requisições por minuto (por IP e por key). Caso ultrapasse, você receberá o erro RATE_LIMIT_EXCEEDED e precisará aguardar 60 segundos para nova tentativa.
Integre ao seu ecossistema de dados
Com a API configurada, acople a Kondado ao seu stack de analytics para automatizar fluxos entre suas fontes e destinos. Explore as possibilidades de destinos disponíveis e visualize seus dados em ferramentas de visualização conectadas à plataforma.
Perguntas frequentes
key e token em todas as requisições. Os tokens herdam as permissões do usuário que os criou e podem ser revogados facilmente sem necessidade de alterar sua senha principal."success":false, "error":"RATE_LIMIT_EXCEEDED" e uma mensagem solicitando nova tentativa após 60 segundos.