Обзор SDK
Официальные SDK для TypeScript и Python — что они добавляют к обычному HTTPS, чем отличаются и как собрать их из исходников, пока они не опубликованы в npm и PyPI.
Два официальных SDK оборачивают публичный API: @dcision/sdk для TypeScript и JavaScript и dcision для Python. Они запускают решения с безопасными повторами, вызывают назначения-функции, проверяют подписи вебхуков и читают ваш аккаунт и выполнения — с одинаковым поведением в обоих языках.
Пока не опубликованы — соберите из исходников
@dcision/sdk пока нет в npm, а dcision — в PyPI. Соберите их из checkout репозитория Dcision, как показано ниже. Пока на этой странице не сказано, что они опубликованы, пакет с такими именами в npm или PyPI не от Dcision: не устанавливайте его.
# In a checkout of the Dcision repository — Node.js 22 and pnpm 10 for the workspace
pnpm install
pnpm --filter @dcision/sdk build # TypeScript: builds packages/sdk/dist
pip install ./packages/sdk-python # Python: installs into the active environmentЗатем добавьте сборку TypeScript в свой проект командой npm install /path/to/dcision/packages/sdk — см. TypeScript SDK и Python SDK.
Что они добавляют
- Повторы, которые никогда не запускают решение дважды. Каждый вызов
decideотправляетIdempotency-Key— ваш или новый UUID, который используют все его повторы, — и повторяет при сетевых ошибках, таймаутах,429,502,503и504, соблюдаяRetry-After. Второй запрос, который застаёт первый ещё выполняющимся, ждёт его, а не завершается ошибкой. - Назначения-функции. Регистрируйте обработчики по имени; SDK вызывает их по порядку после решения.
- Проверка вебхуков. Один вызов проверяет
Dcision-Signatureза постоянное время, временную метку и событие. - Типизированные ответы и один тип ошибки. Каждое поле API типизировано, а каждый сбой — ошибка API, сетевая ошибка, обработчик, выбросивший исключение, неверная подпись — это
DcisionErrorсо стабильнымcode. - Безопасные значения по умолчанию. API-ключ проверяется локально и никогда не выводится; запросы используют
httpsи никогда не следуют редиректам, поэтому ключ не может попасть на другой хост.
Сравнение
| TypeScript | Python | |
|---|---|---|
| Пакет | @dcision/sdk (packages/sdk) | dcision (packages/sdk-python) |
| Среды выполнения | Node.js 20+, Bun, Deno, Cloudflare Workers, Vercel Edge | Python 3.9+ |
| Зависимости | Нет — fetch и Web Crypto | Нет — стандартная библиотека |
| Клиент | Асинхронный (промисы) | Синхронный; в асинхронном коде используйте asyncio.to_thread |
| Запуск решения | dcision.decide(slug, state, options) | client.decide(slug, state, ...) |
| Назначения-функции | functions, decision.dispatch() | functions=, decision.dispatch() |
| Вебхуки | verifyWebhook(), verifySignature() | verify_webhook(), verify_signature() |
| Аккаунт и выполнения | me(), executions.list(), executions.iterate() | me(), executions.list(), executions.iterate() |
| Таймаут каждой попытки | 30 секунд | 30 секунд |
| Повторы | 2 (3 попытки) | 2 (3 попытки) |
Без SDK
API — это один HTTPS POST с JSON, поэтому подойдёт любой язык: см. примеры на cURL, JavaScript и Python в разделе Запуск решения и полный клиент с повторами в разделе Идемпотентные повторы. CLI покрывает терминал и CI — он тоже собирается из исходников.
Лимиты
Все ограничения размеров и количества в одном месте — тело запроса, state и бюджет токенов, схема решения, назначения и доставки, идентификаторы, рабочее пространство, команда и вход.
TypeScript SDK
@dcision/sdk для Node.js, Bun, Deno и edge-сред — сборка из исходников, decide, назначения и функции, ошибки, идемпотентные повторы, executions, me() и проверка вебхуков.