API-sleutels
Gebruik een persoonlijke API-sleutel voor REST-aanvragen vanuit je scripts.
Een sleutel maken en intrekken
Meld je aan bij NinjaBuy en open Account → Verwijzingen → API-sleutels om sleutels met een naam te maken, te bekijken en in te trekken. De volledige sleutel begint met nb_ en wordt maar één keer getoond. Gebruik Sleutel kopiëren om hem veilig op te slaan voordat je het bericht sluit.
Een sleutel verloopt nooit, tenzij je bij het aanmaken een looptijd kiest: 30 dagen, 90 dagen of 1 jaar. Intrekken of het einde van die looptijd geldt vanaf de volgende aanvraag, en een verlopen sleutel verdwijnt uit de lijst.
Alleen een SHA-256-hash van de sleutel wordt opgeslagen.
Een sleutel gebruiken
Geef je sleutel als NINJABUY_API_KEY aan je script door en stuur hem in de 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"]}'Dezelfde header werkt op elke REST-route met authenticatie: Links, Zoeken, uploads en Spreadsheets, en Taken. Het OpenAPI-document vereist geen authenticatie.
Rechten en limieten
Elke sleutel krijgt alle drie de rechten. Er is geen keuzemenu voor scopes.
| Recht | Routes |
|---|---|
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 |
Sleutels en OAuth-REST-aanvragen delen de aanmaak- en zoekvensters van het account. Links maken via MCP deelt ook het aanmaakvenster. Zie Aanroeplimieten.
Een sleutel kan je niet aanmelden, geen sessie openen en geen MCP- of account-API’s aanroepen. Gebruik OAuth voor een toepassing die namens andere NinjaBuy-klanten handelt of voor een MCP-client.
Fouten
Een ongeldige, verlopen of ingetrokken sleutel geeft hetzelfde 401-probleem als een ongeldig OAuth-token. Bij een storing in de sleutelopslag volgt 503 met Retry-After. Zie Fouten.