Recapitulando e Praticando

Principais pontos

• Uma API é um cardápio de pedidos que um programa oferece a outro, e é um contrato: pergunte da forma combinada, receba uma resposta no formato combinado. A maioria dos bugs de API é um dos lados quebrando esse contrato.
• JSON é como a resposta volta — chaves e valores, construídos a partir de objetos { } e arrays [ ], que se aninham. Os tipos de dados são string, number, boolean, null, array, object.
• A armadilha string-versus-number (42 vs "42") e ausente-versus-null são os bugs de formato mais comuns. Você já sabe ler JSON agora — confira o tipo quando algo se comportar de forma estranha.
• Uma chave de API é uma senha. Nunca a envie para o navegador, nunca a comite no git, guarde-a em variáveis de ambiente. Uma chave vazada deve ser rotacionada imediatamente.
• Fique atento a limites de taxa (429) e cobrança medida — laços escritos por IA que chamam uma API paga sem pausa são como você acaba com uma fatura de quatro dígitos. Leia o preço e configure um alerta de orçamento antes.

Experimente

Encontre uma API gratuita e sem chave no seu navegador — por exemplo, abra https://api.github.com/users/octocat diretamente em uma nova aba. Você vai ver uma resposta JSON bruta. Leia-a como um formulário: identifique os objetos { }, encontre um array se houver algum, e nomeie o tipo de três valores diferentes (quais são strings? numbers? booleans? algo é null?). Você acabou de fazer exatamente a checagem que este capítulo pede para você fazer em toda resposta de API que a IA conectar.

Prompt do capítulo

I'm calling an API and I want to check the data shape myself, as a beginner.
Here are the real docs (example request + example response):
<paste the example request and JSON response from the API's docs>

- Before writing parsing code, show me the raw JSON the call returns and
  point out the keys, their types, and anything that might be null or missing.
- Confirm the keys my code reads actually exist in that response.
- Make sure the API key is read from an environment variable on the server,
  never hardcoded or sent to the browser.
- Tell me what happens if the call fails, times out, or hits a rate limit.