_
Dicas para conectar uma API
-
🛠️ Dicas práticas (Lista de verificação)
- Campo URL (obrigatório) : Copie e cole o URL completo sem espaços. Deve começar com https://.
- Chave do Portador : Insira apenas o token (sem o prefixo Bearer). Deixe em branco os campos Make/Zapier.
- Mapeamento : Digite o nome JSON exato (respeitando maiúsculas e minúsculas). Exemplo: nome (e não Nome).
- Corpo chave : Deixe em branco em 95% dos casos; use apenas se a API exigir.
- Teste : Sempre faça testes com dados fictícios (por exemplo, nome="TESTE", e-mail="teste@teste.com").
- Registros : Verifique as configurações do destino (Make, Zapier ou sua API) para diagnosticar o problema.
- Segurança : Nunca compartilhe suas chaves ou URLs de webhook publicamente.
🔒 Segurança
- Trate seus webhooks como se fossem senhas.
- Usar HTTPS exclusivamente.
- Gere novamente o URL do webhook caso ele seja comprometido.
- Use chaves com permissões limitadas, se possível.
🆘 Solução de problemas rápida
Emitir
Causa provável
Solução
Erro 401
Token de portador incorreto ou ausente
Verifique a chave secreta do portador (sem espaços, válida)
Erro 404
URL incorreta
Copie e cole o URL completo novamente
Erro 500
Problema no servidor receptor
Verifique os registros do destinatário
Sem resposta
URL inativa / serviço interrompido
Verifique se o webhook/API está ativo
Dados ausentes
Mapeamento ruim
Verifique se a grafia dos nomes JSON está correta
Formato incorreto
Tipo de dados incompatível
Verifique os tipos esperados (texto, número…)
📞 Precisar de ajuda?
- API proprietária : Consulte seu desenvolvedor ou a documentação da sua API.
- Make : https://www.make.com/en/help
- Zapier : https://help.zapier.com/