La misión
Elige UNA API pública con plan gratuito y construye su interfaz bonita y útil: clima para ciudades (con buscador geocodificado), mapas (punto a punto con distancia y tiempo), o cotizaciones (USD/MXN con gráfico histórico). Tres reglas de ingeniería que definen el proyecto: la clave del servicio vive en TU servidor (la señal 1 del detective aplicada a APIs), las respuestas se cachéan según su vida útil real (el clima de una hora no cambia cada segundo), y los cinco estados del servicio se muestran al usuario sin dramas ni pantallazos de error crudos.
La ruta, seis tiempos
Ruta del proyecto 4
1 · Elegir y leer la documentación (M8, 20 min)
La documentación oficial, LEÍDA POR TI, no por el chat: qué endpoints hay, qué parámetros piden, qué devuelven y qué límites tiene el plan gratis. Elige a propósito un endpoint con un campo interesante (el pronóstico a 5 días, la matriz de distancias): la riqueza de tu app sale de lo que la API realmente ofrece.2 · ESPECIFICACION.md con los cinco estados (M2+M15)
Qué se muestra en: respuesta OK, respuesta LENTA (más de 2 s: indicador visible), VACÍA (la ciudad sin datos), ERROR del servicio (500), y SIN CUOTA (429). Cada estado con su copy de usuario: «sin datos para esa ciudad» no es «Error 204: no content».3 · Backend proxy con caché (M6+prompt)
Tu servidor recibe al usuario, habla con la API con la clave desde variables de entorno, y guarda la respuesta con TTL. El usuario jamás ve el nombre ni la clave del proveedor: solo ve TU app.4 · Revisión con lupa de señales (cnf-oa02)
La clave NO debe estar en el bundle del navegador (F12 lo delata), los estados de error no deben reventar la página, y el log no debe imprimir la clave ni datos completos de respuestas. Tres búsquedas con ctrl-f que valen la auditoría.5 · Probar lo que no brilla (M15)
PRUEBAS.md: ciudad inexistente, corte de red a mitad (simulado o real), agotar la cuota a propósito con 50 clics rápidos y ver qué muestra el usuario, respuesta lenta con throttling del navegador. Aquí se gana el proyecto.6 · Publicar y monitorear (M16+M17)
URL pública, variables de entorno en el servidor real, y una línea en tu rutina mensual (M18-OA03): revisar uso de la API contra el plan. Si te pasas del límite, el aviso es tuyo, no la factura sorpresa.
Paso 1 de 6
El prompt del proxy con caché
Los cinco estados escritos como criterios, el timeout incluido
Proyecto 4: integracion con la API de [SERVICIO]. Documentacion real: [pega ENDPOINT, parametros\ny respuesta de ejemplo]. La clave va en variable de entorno SERVICIO_KEY: jamas en el\nfrontend ni en el repo.\n\nImplementa en mi backend (stack del maestro) el endpoint proxy /app/datos?ciudad=X:\n1. llama a la API real con SERVICIO_KEY desde entorno\n2. CACHE: si tengo respuesta de esa ciudad con menos de [TTL segun el dato], la devuelvo\n de la cache sin llamar; si ya vencio, llamo y actualizo. Reporta X-Cache: HIT/MISS.\n3. ESTADOS: respuesta normal | sin datos (la API devolvio vacio: lo digo, NO invento)\n | error de la API (5xx: mensaje amable, reintento una vez) | SIN CUOTA (429 del\n proveedor: le digo al usuario que espere, y NO reintento en bucle)\n | la API tardo demasiado (timeout 5 s: cortamos y avisamos)\n4. el log registra ciudad, estado y duracion. Nunca la clave, nunca el cuerpo completo.\n\nPruebas automatizadas por cada estado (con la API simulada: mocks). Frontend despues:\nesta capa se aprueba sola primero.Qué entrega este proyecto
| Entregable | Barra alta de este proyecto |
|---|---|
| ESPECIFICACION.md | el contrato de la API externa copiado de su documentación OFICIAL (con enlace), y los cinco estados definidos con su copy |
| HALLAZGOS.md | el prompt de la IA que usó un parámetro que la API real no tiene (¿verificado contra la documentación o "plausible"?) |
| PRUEBAS.md | los cinco estados provocados uno por uno: vacío, error, cuota agotada, lento y normal |
| App publicada | funciona con la red cortada a mitad, sin filtrar la clave, y sin gastar la cuota en cada clic |
Prueba
Tu app muestra el clima y la IA puso la clave del proveedor en el JavaScript del frontend «porque así responde más directo». ¿Qué dos principios rompió?
La API real devolvió una lista vacía para una ciudad: el prompt correcto para la IA es «asegúrate de que nunca devuelva vacío, compleméntalo con la ciudad más cercana».
Paso uno y sin atajos: abre la documentación OFICIAL de tu API elegida y anota a mano los tres datos del contrato (endpoint, parámetros, límite del plan gratis) antes de hablar con la IA. Cuando ella genere el código, tu primera pasada de revisión es ctrl-f contra lo que copiaste, no contra su memoria.
Integrar es confiar en un servicio que no controlas: la documentación leída y los estados probados son tu prima de seguro.
Tu texto se guarda sólo en este dispositivo.
Comentarios
Inicia sesión para comentar.
Todavía no hay comentarios. Sé la primera persona en opinar.