NNorthwindДокументация
Обзор / SDK и CLI

SDK и CLI

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

Обзор

КлиентПакетВерсияСреда
Node.js@northwind/sdk1.6.2Node 18 и новее
Pythonnorthwind-sdk1.6.0Python 3.9 и новее
PHPnorthwind/sdk1.5.4PHP 8.1 и новее
Командная строка@northwind/cli1.6.2Node 18 и новее

Node.js

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

bash
npm install @northwind/sdk
javascript
import { Client } from '@northwind/sdk';

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

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

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

Python

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

bash
pip install northwind-sdk
python
from northwind import Client
import os

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

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

PHP

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

bash
composer require northwind/sdk
php
use Northwind\Client;

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

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

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

КомандаЧто делает
northwind stock push --file stock.csvЗагрузить остатки из CSV, с --dry-run только показать изменения
northwind products get LMP-1708Показать товар со всеми полями
northwind orders list --status confirmedЗаказы в статусе
northwind hooks deliveries --failedНеудачные доставки вебхуков за сутки
northwind hooks retry <id>Повторить доставку

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

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

ВерсияВышлаСтатус
1.615 июля 2026текущая
1.53 июня 2026исправления безопасности
1.49 апреля 2026исправления безопасности