REST API v1

Автоматизация инструментов

Один формат запросов для форматтеров, конвертеров, генераторов и анализаторов. Доступно инструментов: 112. Для повышенных лимитов используйте API-ключ аккаунта.

Список инструментов

GET /api/v1/tools

Возвращает реестр инструментов, поддерживаемые действия и параметры.

Выполнение

POST /api/v1/tools/json-beautifier

{
  "input": "{\"name\":\"test\"}",
  "action": "beautify",
  "options": {}
}

Формат ответа

{
  "ok": true,
  "output": "...",
  "error": null,
  "meta": {
    "tool": "json-beautifier",
    "inputBytes": 12,
    "durationMs": 3,
    "requestId": "..."
  }
}

При ошибке обработки ok будет false, а описание попадёт в error. requestId также возвращается заголовком X-Request-ID.

Авторизация

X-API-Key: dt_live_...

Ключ создаётся в аккаунте. Также поддерживается Authorization: Bearer dt_live_.... На сервере хранится только SHA-256 хэш ключа.

Лимиты

Минутные лимиты задаются через .env; актуальный лимит возвращается в заголовках X-RateLimit-*. Если платёжные провайдеры не настроены, аккаунты используют повышенный лимит без оплаты.

Текущий аккаунт

GET /api/v1/me

Возвращает аккаунт, активный API-ключ, доступные команды с ролями, режим FULL FREE/PRO и фактические лимиты запросов, batch и размера входа. Требуется аккаунт или API-ключ.

Статистика использования

GET /api/v1/usage?days=30

Агрегированная статистика за 1–90 дней: количество запросов и ошибок, обработанные байты, среднее/максимальное время и top tools. Сырые входные данные API в статистику не записываются.

Пакетный API

POST /api/v1/batch

{
  "requests": [
    {"id":"a1","tool":"json-beautifier","input":"{\"a\":1}"},
    {"id":"a2","tool":"base64-encode","input":"hello"}
  ]
}

Каждая операция внутри batch расходует отдельную единицу rate limit. Максимальный размер пакета зависит от режима доступа. В полностью бесплатном режиме используется повышенный лимит.

Сохранённые цепочки

GET /api/v1/pipelines

Возвращает личные и доступные командные цепочки. Для Pipelines 2.0 каждый узел содержит key, type, next и config, а сама цепочка — start и graphVersion. Условия и Fork доступны через тот же API без отдельного endpoint.

Запуск цепочки

POST /api/v1/pipelines/42/run

{
  "input": "{\"name\":\"Кодиха\"}"
}

Вход проходит по графу от стартового узла. Условие выбирает одну ветвь, Fork запускает несколько ветвей от одинакового входа и объединяет их результаты в JSON перед узлом сборки. Ответ содержит финальный output и подробный trace узлов.

Асинхронная очередь

POST /api/v1/jobs/json-beautifier

Для тяжёлых задач авторизованный пользователь с расширенным доступом может поставить обработку в DB-очередь, а затем получить состояние через GET /api/v1/jobs/{id}. Если платёжные системы не настроены, расширенный доступ бесплатен для аккаунтов.

Методы API

Доступные инструменты