Cómo leer la documentación de una API

Vivirás en la documentación de APIs, así que aquí tienes cómo obtener lo que necesitas rápido sin leerla toda. Para cualquier endpoint, busca cinco cosas:

• El método y la URL — GET /forecast. Qué hace, en dos tokens.
• Autenticación — qué encabezado o clave necesita. Normalmente hay una sección compartida para toda la API.
• Parámetros — las entradas que puedes enviar (aquí, city), cuáles son obligatorias y sus tipos.
• Un ejemplo de respuesta — la forma del JSON que obtendrás de vuelta. Esto es oro; cópialo.
• Errores — qué vuelve cuando algo sale mal, y los códigos de estado (401 no autorizado, 404 no encontrado, 429 límite de tasa alcanzado).

La buena documentación incluye un ejemplo de solicitud y respuesta que puedes copiar y pegar. Esos dos fragmentos te dicen más que párrafos de prosa: tómalos y dáselos a la IA.