Ссылка → JSON
API принимает публичную ссылку, запускает распознавание и возвращает адрес задачи. Готовое меню и русский перевод доступны в JSON.
1. Запустить
curl https://menu.slotik.app/api/v1/scans \
-H "Authorization: Bearer $MENU_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"url":"https://qr.bithub.gr/app/8","translate_to":"ru"}'MENU_TOKEN — ваш код доступа к прототипу. Ответ HTTP 202 содержит id, status_url, result_url и ссылку на просмотр menu_url.
2. Получать состояние
Опросите GET /api/v1/scans/{id} с тем же заголовком доступа. Состояния: queued, running, complete, failed. Поле progress показывает текущую стадию. Результат может появиться до окончания перевода.
3. Получить меню
GET /api/v1/scans/{id}/result возвращает разделы, блюда, цены, варианты, фотографии, исходный текст и замечания. Перевод хранится отдельно в translation.texts; исходные цены и состав не перезаписываются.
Пока результата нет, ответ имеет статус HTTP 202. Когда JSON доступен — 200. Проверяйте состояние задачи, полноту перевода и замечания, даже если JSON уже доступен.
Параметры
translate_to: "ru"— русский перевод;null— без перевода.fresh: true— скачать источник заново. По умолчанию известные источники берутся из архива.paid: false— запретить новые платные вызовы. По умолчанию API v1 разрешает их в пределах оценочного бюджета $0.15.
Одновременно обрабатывается одно меню. Если сервис занят, новый запрос получает HTTP 409. Большие PDF могут обрабатываться несколько минут.
QR-код
POST /api/v1/qr, тело {"image":"data:image/jpeg;base64,…"}, возвращает {"url":"https://…"}. Фотография не сохраняется и не отправляется модели.