Como ler a documentação de uma API

Você vai viver dentro de documentações de API, então aqui está como conseguir o que precisa rapidamente sem ler tudo. Para qualquer endpoint, procure por cinco coisas:

• O método e a URL — GET /forecast. O que ele faz, em dois tokens.
• Autenticação — que cabeçalho ou chave ele exige. Geralmente uma seção compartilhada para toda a API.
• Parâmetros — as entradas que você pode enviar (aqui, city), quais são obrigatórias, e seus tipos.
• Um exemplo de resposta — o formato de JSON que você vai receber de volta. Isso é ouro; copie-o.
• Erros — o que volta quando algo dá errado, e os códigos de status (401 não autorizado, 404 não encontrado, 429 limite de taxa atingido).

Boas documentações incluem um exemplo de requisição e resposta prontos para copiar e colar. Esses dois trechos dizem mais do que parágrafos de texto — pegue-os e entregue-os à IA.