Começando com a API da Kondado

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."
}