Обзор / SDK и CLI
SDK и CLI
Официальные клиенты повторяют пути API один в один, сами повторяют запросы при 429 и 503 и проверяют подпись вебхуков одной функцией.
Обзор
| Клиент | Пакет | Версия | Среда |
|---|---|---|---|
| Node.js | @northwind/sdk | 1.6.2 | Node 18 и новее |
| Python | northwind-sdk | 1.6.0 | Python 3.9 и новее |
| PHP | northwind/sdk | 1.5.4 | PHP 8.1 и новее |
| Командная строка | @northwind/cli | 1.6.2 | Node 18 и новее |
Node.js
Типы для TypeScript в комплекте. Клиент не держит глобального состояния: создавайте по экземпляру на ключ.
bash
npm install @northwind/sdkjavascript
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-sdkpython
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/sdkphp
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.6 | 15 июля 2026 | текущая |
| 1.5 | 3 июня 2026 | исправления безопасности |
| 1.4 | 9 апреля 2026 | исправления безопасности |