Заказать демо
ПродуктРешенияТарифыКейсыБлогО насКонтакты Заказать демо
Документация

API и интеграции

REST API для доступа к решениям, поставщикам, КП и истории цен. Вебхуки для событий в реальном времени. Доступно на тарифах Про и Enterprise.

REST + JSON Токен-аутентификация Песочница на демо

Быстрый старт

Получите токен в личном кабинете (раздел «Настройки → API») и сделайте первый запрос. Базовый адрес: https://api.tender-conveyor.ru

curl -H "Authorization: Bearer $TC_TOKEN" \
  "https://api.tender-conveyor.ru/api/v1/decisions?status=ready&limit=20"

Аутентификация

Все запросы передают токен в заголовке Authorization: Bearer <token>. Токен привязан к рабочему пространству и роли. Отозвать токен можно в личном кабинете.

Authorization: Bearer tc_live_9f3a21c8e0b44d17

Решения (decisions)

Основной объект API. Решение содержит закупку, найденного поставщика, цену, маржу и оценку риска.

GET
/api/v1/decisions

Список решений с фильтрами по статусу, категории и дате

GET
/api/v1/decisions/{id}

Карточка решения: закупка, поставщик, цена, маржа, риски

POST
/api/v1/decisions/{id}/approve

Одобрить решение и передать событие в вебхук

POST
/api/v1/decisions/{id}/reject

Отклонить решение с указанием причины

GET
/api/v1/suppliers

Поставщики по позиции или категории с историей цен

GET
/api/v1/tenders

Отобранные закупки и оценки скоринга

GET
/api/v1/quotations

Полученные КП в нормализованном виде

POST
/api/v1/webhooks

Настроить эндпоинт и список событий

{
  "id": "d_8f3a21",
  "status": "ready",
  "tender": { "number": "0173100012...", "price": 4300000 },
  "supplier": { "name": "ООО «СнабТорг»", "price": 3120000 },
  "margin_percent": 27.4,
  "risk": "low",
  "created_at": "2026-09-21T09:12:44Z"
}

Поставщики

Поиск поставщиков по позиции или категории с историей цен и надёжности. Полезно для собственной аналитики закупок.

GET /api/v1/suppliers?position=кабель%20ВВГнг&limit=50

Вебхуки

Подпишитесь на события — и система сама отправит их на ваш эндпоинт. События подтверждаются подписью X-TC-Signature.

События: decision.created, decision.quotations_ready, decision.negotiated, decision.approved, decision.rejected, supplier.found, tender.scored

{
  "event": "decision.approved",
  "decision_id": "d_8f3a21",
  "margin": 27.4,
  "approved_by": "user@company.ru",
  "occurred_at": "2026-09-21T10:02:11Z"
}

Лимиты и ошибки

Лимиты зависят от тарифа. Ошибки возвращаются в стандартном формате с кодом и описанием.

429
rate_limit_exceeded

Превышен лимит запросов, повторите позже

401
unauthorized

Токен отсутствует или отозван

403
forbidden

Недостаточно прав для операции

Нужна помощь с интеграцией?

Напишите на support@tender-conveyor.ru — поможем со схемой обмена и подключением.

Написать в поддержку