Интеграции

API для агрегаторов

Публичный API v1 передает активные и завершённые закупки MikroTon Tender без регистрации: название, описание, заказчика, ИНН, дату создания, срок подачи, начальную цену, позиции и публичные документы закупки. Если закупка опубликована без НМЦ, поле start_price содержит null.

Подключение

Base URL https://tender.mt52.ru/api/v1
Версия v1 / schema 1.1
Часовой пояс Europe/Moscow, МСК

Основные endpoints

GET /api/v1

Версия API, ссылки на документацию и политика совместимости.

GET /api/v1/health

Проверка доступности API.

GET /api/v1/tenders

Список публичных закупок, по которым сейчас идёт приём заявок. Закупки с истёкшим сроком исключаются сразу по времени МСК, даже если регламентное автозакрытие ещё не изменило технический статус. Параметры: page, page_size, q, created_since, updated_since, status=open.

GET /api/v1/tenders/archive

Публичный архив: срок подачи истёк, идёт рассмотрение, назначены торги, принято решение, готовится протокол, процедура завершена или отменена. В каждой записи передаются подробный stage_code, укрупнённый phase_code и result_status.

GET /api/v1/tenders/{id}

Карточка активной или архивной публичной закупки: данные процедуры, позиции, этап и публичные документы.

GET /api/v1/tenders/{id}/documents

Список публичных документов закупки.

GET /api/v1/tenders/{id}/documents/{document_id}/download

Скачивание публичного документа закупки.

Активная выдача и архив

Endpoint /api/v1/tenders предназначен для закупок, в которых ещё можно подать заявку. После окончания срока закупка исчезает из активной выдачи и появляется в /api/v1/tenders/archive. Её прежний URL карточки и публичных документов продолжает работать.

Технический status сохраняется для совместимости. Для точного отображения процедуры используйте phase_code, phase_label, stage_code, stage_label и result_status. Поле phase_code использует единую последовательность: accepting_offers, evaluation, trading, decision, protocol, finished.

Документация OpenAPI

Машиночитаемая схема доступна по адресу /openapi.json, интерактивная документация - /docs.

Пример списка закупок

{
  "meta": {
    "api_version": "v1",
    "schema_version": "1.1",
    "page": 1,
    "page_size": 50,
    "total": 1,
    "total_pages": 1
  },
  "items": [
    {
      "id": 1,
      "title": "Поставка листового алюминия",
      "description": "Открытая закупка материалов",
      "status": "open",
      "stage_code": "accepting_offers",
      "stage_label": "Идет прием заявок",
      "result_status": "accepting_offers",
      "phase_code": "accepting_offers",
      "phase_label": "Прием заявок",
      "phase_position": 1,
      "phase_total": 6,
      "procedure_type": "request_for_proposals",
      "customer": {
        "id": 5,
        "name": "ООО «ПКФ МИКРОТОН»",
        "inn": "5263135670"
      },
      "created_at": "2026-06-01T12:00:00+03:00",
      "submission_deadline": "2026-06-10T16:00:00+03:00",
      "start_price": 125000.0,
      "start_price_includes_vat": true,
      "currency": "RUB",
      "portal_url": "https://tender.mt52.ru/tenders/1",
      "documents_url": "https://tender.mt52.ru/api/v1/tenders/1/documents"
    }
  ]
}

Пример карточки и документов

{
  "id": 1,
  "title": "Поставка листового алюминия",
  "items": [
    {
      "position_index": 1,
      "name": "Лист алюминиевый",
      "unit": "шт",
      "quantity": "300.000",
      "base_vat_rate": "22.000"
    }
  ],
  "documents": [
    {
      "id": 10,
      "filename": "documentation.pdf",
      "doc_type": "tender",
      "uploaded_at": "2026-06-01T12:10:00+03:00",
      "size_bytes": 245760,
      "download_url": "https://tender.mt52.ru/api/v1/tenders/1/documents/10/download"
    }
  ]
}

Ошибки и кеширование

Ответы API содержат заголовки X-MikroTon-API-Version, X-MikroTon-API-Schema, Cache-Control и ETag. Для повторного запроса можно передать If-None-Match; если данные не изменились, API вернет 304 Not Modified. 

{
  "detail": "Tender not found"
}

Типовые коды: 200 - успешный ответ, 304 - данные не изменились, 404 - закупка или документ не найдены, 422 - некорректные параметры запроса.

Время и фильтры

Публичные даты возвращаются в часовом поясе Europe/Moscow с явным смещением +03:00. Срок подачи заявок является московским деловым временем и не должен повторно конвертироваться на стороне агрегатора.

Параметр updated_since поддерживается для совместимости с агрегаторами. В API v1 он фильтрует закупки по дате создания; полноценное поле изменения будет добавлено отдельным расширением без удаления текущего поведения.

Совместимость v1

API v1 развивается добавлением новых полей и endpoints. Уже опубликованные поля и URL сохраняются стабильными для агрегаторов. Архивные публичные закупки передаются без заявок поставщиков, персональных данных пользователей и непубличных документов.