Errori comuni

Questa pagina è costruita sulla distribuzione degli status in produzione negli ultimi 30 giorni. Dove qualcosa non lo misuriamo, lo diciamo esplicitamente.

Nota

I codici di errore non li registriamo nel log delle richieste, solo gli status HTTP. Per questo qui sotto trovi le frequenze degli status, ma non una classifica di codici come INVALID_FIELD. Non ci siamo messi a inventarla.

Errori di percorso

I 4xx più frequenti nel log sono i 404, e quasi nessuno è tuo: sono scanner che provano .env, .git/config, wordpress/, wp-content/…. I veri errori di percorso degli integratori sono altri, e sono già descritti con esempi qui: Le chiamate errate che vediamo più spesso. In breve: /api/… invece di /v1/…, un /v1/v1/… raddoppiato, /swagger.json invece di /v1/openapi.json.

402: il piano non include l’endpoint

385 risposte in 30 giorni. La distribuzione mostra dove il piano gratuito si ferma più spesso:

Endpoint	402 in 30 giorni
chart	114
transit-calendar	101
vedic/dashas/vimshottari/maha	48
ingresses	25
planetary-hours	24
vedic/panchang/full	24
eclipses	13

Nel body della risposta arrivano current_plan e upgrade_to. Non è un errore della richiesta: il body è corretto, la chiave è valida, semplicemente il piano non include quell’endpoint.

429: due limiti diversi

6 791 risposte in 30 giorni, di cui 3 769 senza chiave e 3 022 con chiave. Sono due meccanismi diversi, ed è meglio non confonderli:

• senza chiave il limite si calcola per IP, 30 richieste all’ora. Il blocco più grande nel nostro log non sono nemmeno gli integratori, ma un audit sintetico di Chrome-Lighthouse da 15 indirizzi;
• con chiave il limite è l’RPM del tuo piano. Nella risposta c’è Retry-After in secondi, ed è quello il tempo da aspettare, invece di ritentare subito.

400: quasi sempre il body di una richiesta su un tema

700 risposte in 30 giorni, concentrate sugli endpoint che accettano data, ora e coordinate: chart (111), horoscope/daily (19), transits (18), synastry (15), rectification (15).

L’errore più costoso di questo tipo non è quello che dà 400, ma quello che un tempo dava 200: le grafie abbreviate dei campi. Regole ed esempio di risposta: Formati dei campi.

401 e 403

401 significa chiave mancante o non valida; il messaggio nomina entrambe le classi, aw_ e pk_. 403 riguarda l’origine: la chiave browser pk_ viene rifiutata se la richiesta arriva senza origine o da un dominio estraneo, mentre una chiave limitata a un insieme di endpoint risponde ENDPOINT_NOT_IN_SCOPE ed elenca il proprio insieme in details.

Tabella completa dei codici: Errori.