NNimbusДокументация
Документация Nimbus API

Каталог, цены и заказы в одном API

Здесь всё для интеграции: быстрый старт на пятнадцать минут, разборы типовых сценариев, справочник методов с примерами и библиотеки для Node.js, Python и PHP.

API v1 · стабильная · клиент 1.8.3 от 12 августа 2026
Список товаров
curl "$API/v1/products?limit=2" \
  -H "Authorization: Bearer $NIMBUS_KEY"

# {
#   "data": [ { "sku": "TRM-1579", "stock": 17 }, ... ],
#   "has_more": true
# }
import { Client } from '@nimbus/sdk';

const api = new Client({ key: process.env.NIMBUS_KEY });

const page = await api.products.list({ limit: 2 });
console.log(page.data[0].sku);  // TRM-1579
from nimbus import Client
import os

api = Client(key=os.environ["NIMBUS_KEY"])

page = api.products.list(limit=2)
print(page.data[0].sku)  # TRM-1579

Начните отсюда

Порядок, в котором интеграция собирается быстрее всего. Каждый шаг - отдельная страница с примерами.

  1. Получите ключ песочницыВ кабинете, раздел «Ключи». Ключ начинается с sk_test_ и работает сразу, данные песочницы чистятся каждую ночь.
  2. Сделайте первый запросСписок товаров покажет, что ключ жив и каталог виден. Ответ приходит страницами по курсору.
  3. Залейте остаткиПакетом до 1000 позиций за запрос или утилитой из CSV с проверкой до отправки.
  4. Примите вебхукиБез них заказы не появятся в вашей системе. Проверьте подпись и не обрабатывайте повтор дважды.

Разделы документации

Четыре темы покрывают почти любую интеграцию: что продаётся, что заказали, что произошло и чем это отправлять.

01

Инструменты

Библиотеки, утилита командной строки и песочница.

SDK для Node.jsSDK для PythonУтилита командной строкиПесочница
02

Заказы

Статусы, переходы, частичная отмена и возвраты.

Статусы и переходыПеревод статусаЧастичная отменаВозвраты
03

События

Вебхуки о заказах и остатках, подпись и повторы.

Приём вебхуковПроверка подписиСписок событийПовторы доставки
04

Каталог

Товары, цены в копейках, пакетная загрузка остатков.

Объект товараОстатки пакетомФормат CSVРезервы

Клиентские библиотеки

Официальные клиенты повторяют пути API один в один и сами повторяют запросы при 429 и 503.

Что нового

Внутри v1 только добавляем: ломающие изменения уходят в новую версию пути. Весь журнал

Все системы работаютДоступность рабочего контура за 90 дней - 99,96%. Плановые работы объявляем за 72 часа.Нужна помощь с интеграцией?Обращения из кабинета разбираем в рабочие часы, остановку рабочего контура - круглосуточно.