Trampas
Nada de esto es un error. Es un comportamiento que es mejor conocer a través de la documentación que analizando la respuesta de otro.
La respuesta contiene un campo adicional _footer
Sección titulada «La respuesta contiene un campo adicional _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 analizador es estricto con los campos adicionales, este será el primer obstáculo que encontrará.
Una llamada idéntica repetida no cuesta nada
Sección titulada «Una llamada idéntica repetida no cuesta nada»Una solicitud idéntica dentro de la ventana de caché devuelve X-Cache: HIT, y tal llamada no consume créditos: en la respuesta X-Credits-Used: 0, y el saldo se devuelve. Por lo tanto, no podrás medir el costo ejecutando repetidamente la misma solicitud: pagarás solo una vez.
La clave de Sandbox no consume nada
Sección titulada «La clave de Sandbox no consume nada»aw_test_* no consume créditos en absoluto y no cuenta para el límite de la cuenta. No es una “cuota pequeña”, es cero. Deberías desarrollar con esta clave, y usar aw_live_* solo cuando verifiques la facturación.
Los campos desconocidos se ignoran silenciosamente
Sección titulada «Los campos desconocidos se ignoran silenciosamente»El cuerpo acepta claves adicionales y las ignora. La excepción son las abreviaturas explícitamente rechazadas (lat, tz y otras, véase Formatos de campo). Por lo tanto, un error tipográfico en el nombre del campo normalmente no causará problemas: recibirás 200 y un gráfico calculado sin tu parámetro.
Más allá del Círculo Polar Ártico, el sistema de casas se sustituye
Sección titulada «Más allá del Círculo Polar Ártico, el sistema de casas se sustituye»Para sistemas cuadrantes con |latitude| > 66.5° los cúspides se calculan como Porphyry, ya que estos sistemas no están definidos allí. No lo ocultamos: en la respuesta aparece un campo warning. Whole Sign y Equal funcionan en cualquier latitud.
Hemos cerrado el caso similar: un código houseSystem desconocido ya no devuelve Placidus con otro nombre, sino que devuelve 400.
La clave tiene tres límites independientes
Sección titulada «La clave tiene tres límites independientes»La clave de navegador pk_ y la secreta aw_ pueden tener tres restricciones simultáneas, y no se reemplazan entre sí:
| Límite | Qué indica | 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 | qué se puede llamar específicamente | 403 ENDPOINT_NOT_IN_SCOPE |
El ámbito de los endpoints no libera las lecturas de servicio: una clave restringida a embed/* no podrá leer su propia estadística. Es intencional, los detalles en Autenticación.
La modificación de la clave entra en vigor con la siguiente solicitud
Sección titulada «La modificació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.