Chiavi API
Usa una chiave API personale per chiamare l’API REST dai tuoi script.
Creare e revocare una chiave
Accedi a NinjaBuy e apri Account → Inviti → Chiavi API per creare, elencare e revocare chiavi con nome. La chiave completa inizia con nb_ e viene mostrata una sola volta. Usa Copia chiave per conservarla al sicuro prima di chiudere il messaggio.
Una chiave non scade mai, a meno che tu non scelga una durata quando la crei: 30 giorni, 90 giorni o 1 anno. La revoca o la fine di quella durata si applica dalla richiesta successiva e una chiave scaduta scompare dall’elenco.
Viene memorizzato solo un hash SHA-256 della chiave.
Usare una chiave
Fornisci la chiave al tuo script come NINJABUY_API_KEY e inviala nell’header Authorization:
curl -sS https://www.ninjabuy.com/api/v1/links \
-H "Authorization: Bearer $NINJABUY_API_KEY" \
-H "Content-Type: application/json" \
--data '{"links":["https://weidian.com/item.html?itemID=7581746714"]}'Lo stesso header funziona su tutte le route REST autenticate: Link, Ricerca, caricamenti e Fogli di calcolo, e Operazioni. Il documento OpenAPI non richiede autenticazione.
Permessi e limiti
Ogni chiave riceve tutti e tre i permessi. Non è presente un selettore dei permessi.
| Permesso | Route |
|---|---|
links:create | POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets |
jobs:read | GET /api/v1/jobs/{id} |
search:read | GET /api/v1/search |
Le chiavi e le richieste REST OAuth condividono le finestre di creazione e ricerca dell’account. Anche la creazione di link MCP condivide la finestra di creazione. Consulta Limiti di richieste.
Una chiave non può effettuare l’accesso, aprire una sessione o chiamare MCP o le API dell’account. Usa OAuth per un’applicazione che agisce per altri clienti NinjaBuy o un client MCP.
Errori
Una chiave non valida, scaduta o revocata restituisce lo stesso problema 401 di un token OAuth non valido. Se l’archiviazione delle chiavi non è disponibile, viene restituito 503 con Retry-After. Consulta Errori.