SDK и CLI

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

Обзор

Node.js

Типы для TypeScript в комплекте. Клиент не держит глобального состояния: создавайте по экземпляру на ключ.

npm install @nimbus/sdk

import { Client } from '@nimbus/sdk';

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

// повторы при 429 и 503 включены по умолчанию
const order = await api.orders.get('ORD-25161');

for await (const item of api.products.iterate({ active: true })) {
  // курсор подставляется сам
}

Python

Синхронный и асинхронный клиенты в одном пакете. Ответы - обычные объекты с атрибутами, исходный JSON лежит в .raw.

pip install nimbus-sdk

from nimbus import Client
import os

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

order = api.orders.get("ORD-25161")
for item in api.products.iterate(active=True):
    print(item.sku, item.available)

PHP

Пакет для Composer без зависимостей кроме расширений curl и json.

composer require nimbus/sdk

use Nimbus\Client;

$api = new Client(getenv('NIMBUS_KEY'));
$order = $api->orders->get('ORD-25161');
echo $order->status;

Командная строка

Утилита nimbus нужна для разовых дел: залить прайс, посмотреть товар, повторить доставку вебхука. Ключ берётся из переменной окружения или из файла настроек.

Поддержка версий

Клиент получает исправления безопасности 12 месяцев после выхода следующей минорной версии. Мажорная версия клиента совпадает с версией API: клиент 1.x работает с /v1.