Vai al contenuto principale

​
Metodi di autenticazione

Le API autenticano le richieste con un token API inviato come X-Aegister-Token. Per crearne uno, vedi Token.

​
1. Autenticazione tramite header

Includi X-Aegister-Token negli header della richiesta. È il metodo supportato: mantiene il token fuori dall’URL e dai log del server. Esempio di richiesta:
Esempio con curl:
Esempio di risposta (campi ridotti):
Un token mancante o non valido restituisce HTTP 401:

​
2. Autenticazione tramite parametro di query (deprecata)

Passare il token nell’URL, come parametro di query X-Aegister-Token, è deprecato e verrà rimosso. Un token nell’URL finisce nei log di proxy e server e nella cronologia del browser. Invia invece l’header X-Aegister-Token, come mostrato sopra.

​
Limiti di frequenza

Ogni chiamata API rientra in un limite per account utente: 300 chiamate al minuto, condivise da tutti i tuoi token e dalla tua sessione nella console. Alcune chiamate onerose hanno un limite proprio, sempre per utente: Aegister può inoltre impostare un limite giornaliero su un token, o su un endpoint per il tuo account. Oltre un limite la chiamata risponde HTTP 429 con un header Retry-After, in secondi:
Attendi quei secondi e riprova. Dopo un limite giornaliero Retry-After conta fino alla mezzanotte UTC, e la chiamata rifiutata non viene conteggiata.

​
Dimensione della richiesta

Un corpo della richiesta oltre i 32 MB viene rifiutato con HTTP 413:
Il server risponde senza leggere il resto del caricamento, quindi alcuni client segnalano una connessione interrotta o un 502. Invia un file di log grande in forma grezza (application/octet-stream, fino a 100 MB): vedi «Crea analisi dei log».