Un registro cronológico de cambios, mejoras y nuevas funciones en la API para desarrolladores de akousa.net.
Los contadores de cuota diaria se reinician sin excepción al comenzar cada día UTC. Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset, de modo que un cliente sin cuota puede programar su reintento según la marca de tiempo de reinicio en lugar de sondear la API.
AkousaX-RateLimit-Limit: 50
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1786060800Los endpoints versionados ahora envían Access-Control-Expose-Headers, por lo que el código que se ejecuta en el navegador puede leer X-API-Version, Deprecation, Sunset y Link. Estas cabeceras siempre estuvieron en la respuesta, pero permanecían invisibles para el JavaScript de origen cruzado.
Access-Control-Expose-Headers: X-API-Version, Deprecation, Sunset, LinkLos cambios en la superficie v1 son aditivos: los campos no se eliminan ni se renombran, y cualquier cambio rompedor se publica como una nueva ruta de versión, anunciada antes mediante las cabeceras Deprecation y Sunset. Como pueden aparecer campos nuevos en cualquier momento, los clientes deben ignorar los campos que no reconozcan. X-API-Version pasó a 1.1.0 con este contrato.
X-API-Version: 1.1.0Las claves separadas por producto se unificaron en una única clave ak_. Al crearla eliges los alcances a los que puede llegar — tools, data, analytics, analyze, news y workflow — y las llamadas a endpoints fuera de esos alcances se rechazan. Las claves creadas antes de este cambio conservan el acceso que ya tenían.
POST /api/v1/keys
{
"name": "production",
"scopes": ["tools", "data", "news"]
}Todas las respuestas v1 ahora incluyen la cabecera X-API-Version: 1.0.0. Los clientes pueden usar esta cabecera para verificar qué versión de la API atendió la respuesta e implementar lógica sensible a la versión en sus integraciones.
X-API-Version: 1.0.0Los endpoints bajo /api/v1/data/* responden con un único envoltorio: la carga útil en data y los detalles de entrega en meta — qué servicio respondió, la fuente de origen, si la respuesta vino de la caché y cuánto tardó. El mismo código de análisis sirve para todos los conjuntos de datos.
{
"data": [ ... ],
"meta": {
"service": "earthquakes",
"source": "usgs",
"cached": true,
"executionMs": 34
}
}La API tiene versiones a través de la ruta URL. La versión actual es v1. Los cambios que rompen la compatibilidad resultarán en una nueva versión.
POST /api/v1/sandboxPOST /api/v1/tools/{slug}Deprecation: @1772323200
Link: </docs/api/changelog#changelog-deprecationHeaders>; rel="deprecation", </api/v1/tools/{slug}>; rel="successor-version"La API usa códigos de estado HTTP estándar. Las respuestas de error incluyen un cuerpo JSON con un campo de error que describe el problema.
{
"ok": false,
"error": "Invalid API key",
"code": "UNAUTHORIZED",
"status": 401
}