Инструкция к API (черновик)
Черновая спецификация REST API сервиса. Никакой логики — только описание для дизайнера/разработчика.
Базовый URL
https://api.myservice.kz/v1/ (черновик)
Эндпоинты
GET /companies/{bin}/lots — список выигранных лотов.GET /lots/{lot_id} — детали лота (включая тех. спецификацию).POST /lots/{lot_id}/offer — генерация письма-предложения.POST /lots/{lot_id}/ai-process — обработка лота нейросетью (извлечение требований, подбор аналогов).
Пример: получить лоты по БИН
GET /companies/123456789012/lots?date_from=2024-01-01&date_to=2025-12-31&limit=50&offset=0
Authorization: Bearer <TOKEN>
Response 200:
{
"company_bin": "123456789012",
"total": 128,
"items": [
{
"lot_id": "000123",
"title": "Поставка комплектующих X",
"customer": "ГУ «Министерство ...»",
"win_date": "2025-03-12",
"amount": 15000000,
"currency": "KZT"
}
]
}
Пример тела запроса на генерацию письма
POST /lots/000123/offer
{
"contact_email": "info@customer.kz",
"company_name": "ТОО «Наша Компания»",
"manager_name": "Иван Иванов",
"attachments": ["tech_spec.pdf"],
"lang": "ru"
}
Ошибки (пример)
{
"error": "INVALID_BIN",
"message": "БИН не найден"
}
О проекте
Черновой интерфейс сервиса обработки тендеров с goszakup.gov.kz.
Функции: ввод БИН, просмотр выигранных лотов, тех. спецификации, подготовка предложения, обработка нейросетью или вручную.
Версия: HTML-шаблон без дизайна и логики.