Skip to main content
Una chiave si crea nella dashboard venditore in Venditore → Chiavi API. Viene mostrata una sola volta e agisce per conto dell’account finché non viene revocata.

Inviare la chiave

La chiave accompagna ogni richiesta. Non esistono token intermedi con cui scambiarla.
Solo HTTPS. Una chiave transitata su HTTP in chiaro va considerata compromessa e sostituita.

Cosa raggiunge una chiave

Le offerte del venditore: elencarle (GET /v1/offers/my), crearle, modificarle, gestire le unità, ritirarle e archiviarle. Tutto ciò che la dashboard protegge con un secondo fattore — cambiare l’email dell’account, le impostazioni 2FA, i prelievi — è fuori dalla portata di una chiave.

Elenco di indirizzi consentiti

Facoltativo. Se la tua integrazione gira da indirizzi fissi, indicali quando crei la chiave (un indirizzo o una sottorete, fino a 16 voci) e la chiave verrà rifiutata da qualsiasi altro luogo. Un elenco vuoto significa qualsiasi indirizzo.

Limiti di frequenza

Superarli restituisce 429. È un rifiuto temporaneo: attendi e riprova, la chiave resta valida.

Ruotare una chiave

Un account può avere fino a 5 chiavi. Crea la sostituta prima che ti serva: punta l’integrazione alla nuova chiave, verifica che funzioni, poi revoca la vecchia. Nel frattempo non deve fermarsi nulla.

Errori