Deixando a IA fazer as chamadas — enquanto você confere o formato
Aqui está a divisão prática de trabalho. A IA é genuinamente boa em escrever código que chama APIs: ela conhece as bibliotecas, a sintaxe dos cabeçalhos, o tratamento de erros. Deixe que ela faça isso. Você não precisa escrever esse encanamento na mão.
Mas você é dono de uma coisa em que a IA é ruim: saber se o formato dos dados está realmente correto. Um bom fluxo de trabalho:
- Dê à IA a documentação real. Cole o exemplo de requisição e resposta da documentação no seu . A IA chutando o formato de uma de memória é uma das principais fontes de bugs — ela vai inventar chaves que parecem plausíveis mas não existem. Exemplos reais a ancoram na realidade.
- Peça para ela te mostrar a resposta bruta primeiro. "Antes de processar, registre (log) o real que a API retorna." Depois, compare visualmente com o que o código espera. A chave que ele lê (
response.current.temp) realmente existe na resposta? Metade dos bugs de API é um nome de chave que não bate. - Confira os tipos. Isso é um número ou uma string? Um campo que deveria sempre estar presente às vezes vem
null? Você já sabe ler JSON — use isso. - Trate o caminho infeliz. Pergunte: "O que acontece se essa chamada falhar, expirar (timeout), ou atingir o limite de taxa?" Se a resposta for "o app trava," isso é um bug, não uma funcionalidade.
Você não precisa escrever a requisição. Você precisa ler a resposta e perguntar "esse é o formato que eu esperava?" Esse único hábito — checar os dados contra o contrato — pega a maioria dos bugs de integração antes que seus usuários sequer os vejam.