8 800 123-45-67 | info@etpgpt.ru
Помощь Контакты

API документация

Интегрируйте возможности etpGPT в ваши системы

Введение

API etpGPT позволяет интегрировать возможности AI-помощника по закупкам в ваши корпоративные системы, CRM и ERP.

Базовый URL для всех запросов:

https://api.etpgpt.ru/v1

API использует REST-архитектуру и возвращает ответы в формате JSON.

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

Для доступа к API необходим API-ключ, который передаётся в заголовке каждого запроса:

Authorization: Bearer YOUR_API_KEY

API-ключ можно получить в личном кабинете на тарифе «Бизнес».

Важно: Храните API-ключ в безопасности. Не публикуйте его в открытых репозиториях и не передавайте третьим лицам.

Эндпоинты

Метод Эндпоинт Описание
POST /chat Отправить вопрос AI-помощнику
POST /documents/analyze Анализ закупочной документации
POST /nmck/calculate Расчёт НМЦК
GET /history История запросов
GET /usage Статистика использования

Чат с AI

Отправка вопроса AI-помощнику и получение ответа.

Запрос

POST /v1/chat
Content-Type: application/json

{
  "message": "Какие документы нужны для участия в аукционе по 44-ФЗ?",
  "context": "procurement",
  "law": "44-fz"
}

Параметры запроса

Параметр Тип Обязательный Описание
message string Да Текст вопроса (до 4000 символов)
context string Нет Контекст: procurement, documents, nmck
law string Нет Закон: 44-fz, 223-fz, 615-pp

Ответ

{
  "success": true,
  "data": {
    "id": "msg_123456",
    "response": "Для участия в электронном аукционе по 44-ФЗ вам потребуются следующие документы:\n\n1. Заявка на участие...",
    "sources": [
      {
        "title": "Статья 66 44-ФЗ",
        "url": "http://pravo.gov.ru/..."
      }
    ],
    "tokens_used": 450
  }
}

Анализ документов

Загрузка и анализ закупочной документации.

Запрос

POST /v1/documents/analyze
Content-Type: multipart/form-data

file: [binary]
analysis_type: "risks"

Параметры

Параметр Тип Описание
file file Документ (PDF, DOCX до 10 МБ)
analysis_type string Тип: risks, compliance, summary

Ответ

{
  "success": true,
  "data": {
    "document_id": "doc_789",
    "analysis": {
      "risks": [
        {
          "level": "high",
          "description": "Слишком короткие сроки поставки",
          "recommendation": "Запросить разъяснения..."
        }
      ],
      "compliance_score": 85,
      "summary": "Техническое задание на поставку..."
    }
  }
}

Расчёт НМЦК

Расчёт начальной максимальной цены контракта.

Запрос

POST /v1/nmck/calculate
Content-Type: application/json

{
  "method": "market_analysis",
  "items": [
    {
      "name": "Компьютер офисный",
      "quantity": 10,
      "unit": "шт",
      "prices": [45000, 48000, 52000]
    }
  ]
}

Методы расчёта

  • market_analysis — метод сопоставимых рыночных цен
  • normative — нормативный метод
  • tariff — тарифный метод
  • cost — затратный метод

Ответ

{
  "success": true,
  "data": {
    "nmck": 483333.33,
    "currency": "RUB",
    "method": "market_analysis",
    "calculation": {
      "average_price": 48333.33,
      "coefficient_variation": 7.2,
      "prices_valid": true
    }
  }
}

Обработка ошибок

API возвращает стандартные HTTP-коды состояния:

Код Описание
200 Успешный запрос
400 Некорректный запрос
401 Ошибка аутентификации
429 Превышен лимит запросов
500 Внутренняя ошибка сервера 
{
  "success": false,
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Превышен лимит запросов. Попробуйте позже.",
    "retry_after": 60
  }
}

Лимиты

Тариф Запросов/мин Запросов/день Размер файла
Бизнес 60 10 000 10 МБ
Enterprise 300 Безлимит 50 МБ

Готовы начать интеграцию?

Свяжитесь с нами для получения API-ключа и технической консультации.

Связаться с нами