API-Schlüssel
Verwende einen persönlichen API-Schlüssel für REST-Aufrufe aus deinen Skripten.
Schlüssel erstellen und widerrufen
Melde dich bei NinjaBuy an und öffne Konto → Empfehlungen → API-Schlüssel, um benannte Schlüssel zu erstellen, aufzulisten und zu widerrufen. Der vollständige Schlüssel beginnt mit nb_ und wird nur einmal angezeigt. Sichere ihn mit Schlüssel kopieren, bevor du die Meldung schließt.
Ein Schlüssel läuft nie ab, es sei denn, du wählst beim Erstellen eine Laufzeit: 30 Tage, 90 Tage oder 1 Jahr. Ein Widerruf oder das Ende dieser Laufzeit gilt ab der nächsten Anfrage, und ein abgelaufener Schlüssel verschwindet aus der Liste.
Gespeichert wird nur ein SHA-256-Hash des Schlüssels.
Schlüssel verwenden
Stelle den Schlüssel deinem Skript als NINJABUY_API_KEY bereit und sende ihn im 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"]}'Derselbe Header funktioniert auf allen authentifizierten REST-Routen: Links, Suche, Uploads und Tabellen sowie Aufträge. Die OpenAPI-Spezifikation benötigt keine Authentifizierung.
Berechtigungen und Limits
Jeder Schlüssel erhält alle drei Berechtigungen. Eine Auswahl gibt es nicht.
| Berechtigung | Routen |
|---|---|
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 |
Schlüssel und OAuth-REST-Anfragen teilen sich die Erstellungs- und Suchfenster des Kontos. Die Linkerstellung über MCP nutzt dasselbe Erstellungsfenster. Siehe Ratenlimits.
Ein Schlüssel kann keine Anmeldung durchführen, keine Sitzung öffnen und weder MCP noch Konto-APIs aufrufen. Verwende OAuth für eine Anwendung, die für andere NinjaBuy-Kunden handelt, oder einen MCP-Client.
Fehler
Ein ungültiger, abgelaufener oder widerrufener Schlüssel ergibt dasselbe 401-Problem wie ein ungültiges OAuth-Token. Bei einem Ausfall des Schlüsselspeichers wird 503 mit Retry-After zurückgegeben. Siehe Fehler.