Domande frequenti e Errori comuni sull'uso delle API
Stato del servizio API
La nostra API viene monitorata ogni 60 secondi tramite richieste automatiche. Puoi consultare lo storico e i risultati delle verifiche direttamente qui:
Obbligo di User-Agent nelle richieste API
Per motivi di sicurezza, il nostro sistema rifiuta automaticamente le richieste HTTP prive di header User-Agent o con User-Agent non valido.
Secondo lo standard RFC, ogni richiesta dovrebbe includere uno User-Agent identificabile. Le richieste senza questo header possono infatti essere considerate potenzialmente dannose o automatizzate.
Le richieste che non rispettano questa regola potrebbero essere bloccate automaticamente dai nostri sistemi di protezione.
Per evitare questo problema:
- Impostare sempre un User-Agent personalizzato nelle richieste.
- Esempio consigliato:
User-Agent: MioCodiceFiscaleAPI/1.0
Se usi librerie HTTP come Guzzle, cURL o simili, configura l’header User-Agent prima di effettuare le chiamate.
In alternativa, puoi usare un User-Agent personalizzato con il nome e la versione della tua applicazione.
Nota sugli errori 429
(Too Many Requests)
Alcuni utenti potrebbero ricevere la risposta HTTP 429 Too Many Requests anche con poche richieste consecutive.
Questo non dipende dal servizio API in sé, ma da regole di sicurezza introdotte dal provider di hosting che bloccano o limitano le richieste provenienti da client con User-Agent generici (es. GuzzleHttp/7, curl, PHP).
Per evitare questo problema:
- Impostare sempre un User-Agent personalizzato nelle richieste.
- Esempio consigliato:
User-Agent: MioCodiceFiscaleAPI/1.0
Se usi librerie HTTP come Guzzle, cURL o simili, configura l’header User-Agent prima di effettuare le chiamate.
In alternativa, puoi usare un User-Agent personalizzato con il nome e la versione della tua applicazione.
Sei giunto sul nostro sito numerose volte e lo consideri utile? Aiutaci a tenerlo attivo. Versando un piccolo contributo puoi contribuire alle spese di hosting e di traffico. Ogni contributo, anche minimo, è benaccetto. Dona tramite PayPal o tramite Stripe (carta di credito), la tua collaborazione è preziosa! Grazie.