API для интеграций

HTTP API платформы. По умолчанию парсер работает централизованно через прокси — внешний сервер не нужен. Эти эндпоинты пригодятся, если вы хотите подключить собственный парсер или расширение. Ключи — в кабинете, раздел «Настройки».

Приём заявки от парсера

Контракт совместим с рабочим парсером (паттерн UPLOAD_BASE_URL + UPLOAD_API_KEY): укажите на своём сервере парсера адрес платформы и ключ приёма.

POST /api/autosearch/intake
X-Autosearch-Api-Key: <ключ приёма из кабинета>
Content-Type: multipart/form-data

screenshot=<PNG/JPG>          # скриншот «чистой» заявки
manager_id=<строка, опц.>     # внешний id менеджера
source_run_id=<число, опц.>   # id запуска на стороне парсера
ati_order_number=<строка, опц.>

→ 200 {"cargo_id": 123, "source_run_id": ..., "ati_order_number": ...}
→ 402 тестовый период исчерпан
→ 403 неверный ключ

После приёма заявка автоматически распознаётся и публикуется по правилам кабинета.

API расширения

GET  /api/ext/status            X-Extension-Key: <ключ>   # кабинет, квота, последние заявки
POST /api/ext/submit            X-Extension-Key: <ключ>   # multipart: screenshot, ati_order_number?, page_url?
GET  /api/ext/cargo/{id}        X-Extension-Key: <ключ>   # статус заявки

Управление внешним парсером со стороны платформы

Если профиль парсинга в режиме «внешний», платформа вызывает раннер вашего сервера:

POST {runner_base_url}/runner/start
X-Runner-Api-Key: <ключ раннера>
{"run_id": 1, "filters": {"min_price_with_vat": 100000, "min_price_per_km": 70,
  "min_vat_gap_percent": 12, "single_load_point": true, "single_unload_point": true,
  "country": "RUS", "firm_folders": ["..."], "max_publications": 0, "rows_per_page": 100}}

Найденные «чистые» заявки парсер отправляет обратно на /api/autosearch/intake.

Вебхук платежей

POST /api/webhooks/yoomoney    # уведомления YooMoney (проверка подписи sha1)