Lição 4
Depuração segura de APIs
Mascarar segredos, evitar execução acidental e revisar código de requisição gerado.
Comandos cURL frequentemente contêm tokens reais, cookies, emails, ids de clientes e hostnames internos. Trate-os como artefatos sensíveis de depuração.
Mascare antes de compartilhar
Substitua segredos antes de colar comandos em issues, chats, docs ou ferramentas de IA:
Authorization: Bearer <redacted>
Cookie: session=<redacted>
X-Api-Key: <redacted>
Não confie na memória. Faça da mascaragem um hábito.
Evite execução acidental
Um conversor local deve analisar o comando sem enviar a requisição. Isso importa porque comandos cURL copiados podem criar dados, apagar registros, disparar pagamentos ou chamar produção.
Se precisar executar a requisição, faça isso intencionalmente no ambiente correto.
Revise o código gerado
Antes de usar código convertido, verifique:
- Ele envia o mesmo método?
- Os headers foram preservados?
- O corpo foi codificado do mesmo modo?
- Tokens ficaram hardcoded?
- O runtime suporta a requisição?
- Erros são tratados?
Mantenha reprodutibilidade
Ao depurar um bug, preserve o comando cURL original em local seguro e mantenha o código convertido por perto. O comando original é evidência; o código convertido é um rascunho de implementação.
Boa depuração de API é cuidadosa: analisar, inspecionar, mascarar, converter e revisar.