API
Resumen
Convenciones generales, base URL, formato de errores y versionado.
Versión: 0.1.0 (MVP entrega 1, abril 2026).
Base URL: https://poi8bb5go9.execute-api.us-east-1.amazonaws.com.
Región: us-east-1.
Esta sección es la fuente de verdad del contrato entre frontend y backend. Cualquier discrepancia entre código o infra contra estos documentos es un bug.
Convenciones
| Tema | Valor |
|---|---|
| Protocolo | HTTPS, HTTP/1.1 |
| Content-Type | application/json (request y response) |
| Encoding | UTF-8 |
| Timestamps | ISO 8601 UTC con sufijo Z |
| IDs | UUID v4 |
| Auth | ninguna en MVP — endpoint público |
| CORS | Access-Control-Allow-Origin: * durante el demo |
| Rate limit | ninguno aplicado en MVP — aplican cuotas implícitas de Bedrock y API Gateway |
Endpoints
POST /classify
Clasifica un clip de audio y devuelve la categoría predicha junto con vecinos para explicabilidad.
GET /health
Sanity check. Estado del servicio y del índice vectorial.
Errores
Códigos estables, formato uniforme y mapeo a HTTP.
Catálogo de clases
50 clases ESC-50 con etiqueta en español y grupo.
Versionado
- Cualquier cambio breaking sube
MAJORy se documenta aquí. - Cambios aditivos (campos opcionales nuevos) suben
MINOR. - El frontend debe ignorar campos desconocidos (forward compatibility).
- El backend no debe quitar campos sin bumpear
MAJOR.
Pendientes futuros (no MVP)
- Auth (API key o Cognito).
GET /history?limit=Ncon últimas clasificaciones de DynamoDB.- WebSocket para streaming continuo.
- Soporte multipart/form-data para archivos grandes.
- Rate limiting por IP / API key.