Klucze API
Używaj osobistego klucza API do wywołań REST ze swoich skryptów.
Tworzenie i unieważnianie klucza
Zaloguj się do NinjaBuy i otwórz Konto → Polecenia → Klucze API, aby tworzyć, przeglądać i unieważniać nazwane klucze. Pełny klucz zaczyna się od nb_ i jest pokazywany tylko raz. Użyj Kopiuj klucz, aby zapisać go bezpiecznie przed zamknięciem komunikatu.
Klucz nigdy nie wygasa, chyba że przy tworzeniu wybierzesz okres ważności: 30 dni, 90 dni lub 1 rok. Unieważnienie lub koniec tego okresu obowiązuje od następnego żądania, a wygasły klucz znika z listy.
Przechowywany jest wyłącznie skrót SHA-256 klucza.
Używanie klucza
Przekaż klucz do skryptu jako NINJABUY_API_KEY i wysyłaj go w nagłówku 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"]}'Ten sam nagłówek działa na każdej uwierzytelnianej trasie REST: Linki, Wyszukiwanie, przesyłanie plików i Arkusze oraz Zadania. Dokument OpenAPI nie wymaga uwierzytelniania.
Uprawnienia i limity
Każdy klucz otrzymuje wszystkie trzy uprawnienia. Nie ma wyboru zakresów.
| Uprawnienie | Trasy |
|---|---|
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 |
Klucze i żądania REST z OAuth współdzielą okna tworzenia i wyszukiwania konta. Tworzenie linków przez MCP również korzysta z tego okna tworzenia. Zobacz Limity wywołań.
Klucz nie pozwala się zalogować, otworzyć sesji ani wywoływać MCP czy API konta. Używaj OAuth dla aplikacji działającej w imieniu innych klientów NinjaBuy lub klienta MCP.
Błędy
Nieprawidłowy, wygasły lub unieważniony klucz zwraca ten sam problem 401 co nieprawidłowy token OAuth. Awaria magazynu kluczy zwraca 503 z Retry-After. Zobacz Błędy.