Pular para o conteúdo
Tinko API

Perguntas Frequentes (FAQ)

Respostas para as dúvidas mais comuns sobre a nossa API.

Geral

Como posso começar a usar a API?

Você precisa gerar um token de acesso no painel do Tinko. Vá em Configurações → API e clique em Gerar Token. O passo a passo está em Como Começar.

Como funciona a autenticação?

Usamos Bearer Token para autenticar as requisições. Inclua o token no header Authorization de todas as requisições:

Terminal window
curl -X GET "https://api.tinko.com.br/v1/users" \
  -H "Authorization: Bearer seu_token_aqui"

Veja mais detalhes em Autenticação.

Existem limites de uso da API?

Sim. Aplicamos os limites por token e os calculamos por minuto:

CategoriaLimite
Envio de mensagens20/min
Verificação de número10/min
Leitura (GET)60/min
Escrita (POST, PUT, DELETE)30/min

Veja mais detalhes em Limites de Requisições.

O que acontece se eu exceder o limite de requisições?

Suas requisições serão bloqueadas e você receberá um erro 429 Too Many Requests. Aguarde o tempo indicado no campo retry_after da resposta antes de fazer novas requisições.

Erros Comuns

Erro 400 - Bad Request

A requisição está malformada ou contém dados inválidos.

Causas comuns:

  • JSON com erro de sintaxe
  • Campos obrigatórios faltando
  • Tipo de dados incorreto

Solução: Verifique a sintaxe do JSON e os campos obrigatórios do endpoint.

Erro 401 - Unauthorized

Falha na autenticação.

Causas comuns:

  • Token não enviado no header
  • Token inválido ou expirado
  • Token revogado

Solução: Verifique se o header Authorization: Bearer SEU_TOKEN está correto.

Erro 403 - Forbidden

Você não tem permissão para acessar o recurso.

Causas comuns:

  • Tentativa de acessar recurso de outra empresa
  • API desabilitada para sua conta
  • Permissões insuficientes

Solução: Verifique se você tem acesso ao recurso solicitado.

Erro 404 - Not Found

O recurso solicitado não foi encontrado.

Causas comuns:

  • URL do endpoint incorreta
  • Token do recurso não existe
  • Recurso foi deletado

Solução: Verifique a URL e o token do recurso.

Erro 409 - Conflict

O recurso está em um estado que impede a operação.

Causas comuns:

  • Canal desconectado
  • Recurso em uso

Solução: Verifique a mensagem de erro e resolva o conflito antes de tentar novamente.

Erro 422 - Validation Error

Os dados enviados não passaram na validação.

Causas comuns:

  • E-mail duplicado
  • Senha muito curta
  • Formato de telefone inválido

Solução: Leia o campo errors da resposta para ver quais campos estão inválidos.

Erro 429 - Too Many Requests

Você excedeu o limite de requisições.

Solução: Aguarde o tempo indicado em retry_after (em segundos) antes de fazer novas requisições.

Erro 500 - Internal Server Error

Erro interno do servidor.

Solução: Tente novamente mais tarde. Se o erro persistir, entre em contato com o suporte.

Webhooks

Como configuro um webhook?

No painel do Tinko, vá em Configurações → Webhooks, clique em Novo Webhook e preencha a URL e os eventos que quer receber. Detalhes em Configuração de Webhooks.

Por que meu webhook não está sendo recebido?

Verifique:

  • A URL está acessível publicamente
  • A URL usa HTTPS
  • O webhook está ativo no painel
  • Os eventos desejados estão selecionados
  • Seu servidor responde com status 200

Como evitar webhooks duplicados?

Use o campo webhook_token do payload para identificar e ignorar webhooks já processados.

Não encontrou sua resposta?

Entre em contato com nosso suporte: