Обзор 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 и никогда не следуют редиректам, поэтому ключ не может попасть на другой хост.

Сравнение

TypeScriptPython
Пакет@dcision/sdk (packages/sdk)dcision (packages/sdk-python)
Среды выполненияNode.js 20+, Bun, Deno, Cloudflare Workers, Vercel EdgePython 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 — он тоже собирается из исходников.

На этой странице