Ключи API
Используйте личный ключ API для REST-запросов из своих скриптов.
Создание и отзыв ключа
Войдите в NinjaBuy и откройте Аккаунт → Приглашения → Ключи API, чтобы создавать, просматривать и отзывать именованные ключи. Полный ключ начинается с nb_ и показывается только один раз. Нажмите Копировать ключ, чтобы сохранить его в безопасном месте до закрытия сообщения.
Ключ не истекает, если при создании не выбрать срок действия: 30 дней, 90 дней или 1 год. Отзыв или окончание этого срока действует со следующего запроса, а истёкший ключ исчезает из списка.
Хранится только хеш ключа SHA-256.
Использование ключа
Передайте ключ скрипту как NINJABUY_API_KEY и отправляйте его в заголовке 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"]}'Один и тот же заголовок работает на всех REST-маршрутах с аутентификацией: Ссылки, Поиск, загрузки и Таблицы, а также Задания. Документ OpenAPI не требует аутентификации.
Разрешения и ограничения
Каждый ключ получает все три разрешения. Выбора областей доступа нет.
| Разрешение | Маршруты |
|---|---|
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 |
Ключи и REST-запросы с OAuth используют общие окна создания и поиска аккаунта. Создание ссылок через MCP также использует это окно создания. См. Ограничения частоты.
Ключ не позволяет войти, открыть сеанс или вызвать MCP либо API аккаунта. Используйте OAuth для приложения, действующего от имени других клиентов NinjaBuy, или клиента MCP.
Ошибки
Недействительный, истёкший или отозванный ключ возвращает ту же проблему 401, что и недействительный токен OAuth. При недоступности хранилища ключей возвращается 503 с Retry-After. См. Ошибки.