Insidie
Niente di tutto ciò è un errore. È un comportamento meglio conosciuto dalla documentazione che dal tentativo di interpretare una risposta altrui.
Nella risposta c’è un campo extra _footer
Sezione intitolata “Nella risposta c’è un campo extra _footer”Il piano gratuito e ogni chiamata senza chiave riceve nel corpo un campo aggiuntivo _footer con una firma. Le chiavi a pagamento non lo vedono. Se il tuo parser è rigido sui campi extra, questo sarà il primo ostacolo che incontrerà.
Una chiamata identica costa zero
Sezione intitolata “Una chiamata identica costa zero”Una richiesta identica all’interno della finestra di caching restituisce X-Cache: HIT, e tale chiamata non consuma crediti: nella risposta X-Credits-Used: 0, mentre il saldo viene restituito. Quindi misurare il costo inviando la stessa richiesta più volte non funzionerà: pagherai una sola volta.
La chiave Sandbox non consuma nulla
Sezione intitolata “La chiave Sandbox non consuma nulla”aw_test_* non consuma crediti affatto e non rientra nel limite dell’account. Non è una “piccola quota”, è zero. Sviluppare dovrebbe avvenire proprio con questa, mentre aw_live_* dovrebbe essere usato solo quando si verifica il fatturazione.
I campi sconosciuti passano in silenzio
Sezione intitolata “I campi sconosciuti passano in silenzio”Il corpo accetta chiavi extra e le ignora. L’eccezione è solo per le rappresentazioni corte esplicitamente rifiutate (lat, tz e altre, vedi Formati dei campi). Quindi una battitura errata nel nome del campo di solito non si farà notare: riceverai 200 e una mappa calcolata senza il tuo parametro.
Oltre il circolo polare il sistema delle case viene sostituito
Sezione intitolata “Oltre il circolo polare il sistema delle case viene sostituito”Per i sistemi quadranti con |latitude| > 66.5° i cuspidi vengono calcolati come Porphyry, poiché questi sistemi non sono definiti lì. Non lo nascondiamo: nella risposta appare un campo warning. Whole Sign ed Equal funzionano a qualsiasi latitudine.
Un caso simile abbiamo chiuso con un rifiuto: un codice sconosciuto houseSystem non restituisce più Placidus con un nome diverso, ma restituisce 400.
La chiave ha tre limiti indipendenti
Sezione intitolata “La chiave ha tre limiti indipendenti”La chiave per browser pk_ e quella segreta aw_ possono avere fino a tre limitazioni contemporaneamente, e non si sostituiscono a vicenda:
| Limite | Cosa dice | Rifiuto |
|---|---|---|
| elenco dei domini | da dove è possibile chiamare | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | quanti crediti può consumare questa chiave | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | cosa è possibile chiamare | 403 ENDPOINT_NOT_IN_SCOPE |
L’ambito degli endpoint non libera le letture di servizio: una chiave limitata a embed/* non leggerà neanche le proprie statistiche. È intenzionale, i dettagli sono in Autenticazione.
La modifica della chiave entra in vigore dalla richiesta successiva
Sezione intitolata “La modifica della chiave entra in vigore dalla richiesta successiva”Le chiavi vengono cacheggiate per 60 secondi, ma qualsiasi modifica tramite PATCH /v1/keys/{id} azzera la cache immediatamente. Non è necessario aspettare un minuto.