Trampas
Nada de esto es un error. Es un comportamiento que es mejor aprender de la documentación que de analizar la respuesta de otro.
En la respuesta hay un campo extra _footer
Sección titulada «En la respuesta hay un campo extra _footer»El plan gratuito y cualquier llamada sin clave reciben en el cuerpo un campo adicional _footer con una firma. Las claves de pago no lo ven. Si tu parser es estricto con los campos extra, este será el primer obstáculo que encontrará.
Una llamada idéntica repetida cuesta cero
Sección titulada «Una llamada idéntica repetida cuesta cero»Una solicitud idéntica dentro de la ventana de caché devuelve X-Cache: HIT, y tal llamada no deduce créditos: en la respuesta X-Credits-Used: 0, y el saldo restante se devuelve. Por lo tanto, no podrás medir el costo ejecutando repetidamente la misma solicitud: pagarás una sola vez.
La clave de Sandbox no gasta nada
Sección titulada «La clave de Sandbox no gasta nada»aw_test_* no deduce créditos en absoluto y no se cuenta en el límite de la cuenta. No es una “cuota pequeña”, es cero. Deberías desarrollar con ella, y usar aw_live_* solo cuando verifiques la facturación.
Los campos desconocidos se pasan por alto
Sección titulada «Los campos desconocidos se pasan por alto»El cuerpo acepta claves adicionales y las ignora. La excepción son solo las notaciones cortas rechazadas explícitamente (lat, tz y el resto, véase Formatos de campo). Por lo tanto, un error tipográfico en el nombre de un campo normalmente no se notará: obtendrás 200 y un gráfico calculado sin tu parámetro.
Al norte del Círculo Polar Ártico, el sistema de casas se reemplaza
Sección titulada «Al norte del Círculo Polar Ártico, el sistema de casas se reemplaza»Para sistemas cuadrantes con |latitude| > 66.5°, Swiss Ephemeris devuelve silenciosamente Porphyry. No lo ocultamos: aparece un campo warning en la respuesta. Whole Sign y Equal funcionan en cualquier latitud.
Cerramos el caso vecino con una denegación: los códigos houseSystem desconocidos ya no dan Placidus bajo otro nombre, sino que devuelven 400.
La clave tiene tres límites independientes
Sección titulada «La clave tiene tres límites independientes»La clave del navegador pk_ y la secreta aw_ pueden llevar tres restricciones a la vez, y no se reemplazan entre sí.
| Límite | Qué dice | Rechazo |
|---|---|---|
| lista de dominios | desde dónde se puede llamar | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | cuánto puede gastar esta clave | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | exactamente qué se puede llamar | 403 ENDPOINT_NOT_IN_SCOPE |
El ámbito de los endpoints no libera las lecturas de servicio: una clave restringida a embed/* tampoco leerá sus propias estadísticas. Es intencional, los detalles en Autenticación.
La edición de la clave entra en vigor con la siguiente solicitud
Sección titulada «La edición de la clave entra en vigor con la siguiente solicitud»Las claves se almacenan en caché durante 60 segundos, pero cualquier cambio a través de PATCH /v1/keys/{id} restablece la caché inmediatamente. No es necesario esperar un minuto.