Быстрый старт

Путь подключения

1. Подпишите контракт по робототехнике; Sitora регистрирует вас как поставщика.
2. Интегрируйтесь с песочницей, которую предоставит Sitora.
3. Пройдите набор проверок соответствия — успешный прогон записывается и прикрепляется к вашей сертификации. Без него Sitora не может сертифицировать поставщика.
4. После сертификации владелец ресторана запрашивает ваш парк для своего филиала из Sitora Biz; Sitora одобряет активацию; владелец создаёт ваши учётные данные и (при необходимости) регистрирует ваш webhook-адрес.

Песочница

Sitora выдаёт каждому поставщику песочницу: полностью укомплектованный тестовый филиал с зарегистрированным поставщиком, активной активацией, учётными данными и подготовленными заказами уже в состоянии ready — предложения существуют с момента подключения. Песочница ведёт себя ровно как production: тот же API, те же ограничения, те же коды ошибок, те же аварийные выключатели.

Учётные данные песочницы выдаются один раз, при подготовке. Сохраните их; повторно получить их нельзя — потерянный ключ означает ротацию.

Первые запросы

Опросите предложения, примите одно и доведите его до завершения:

# 1. Что предлагается?
curl -H "Authorization: Bearer sit_rk_..." \
  "https://<host>/api/robotics/v1/serving-tasks/?status=offered"

# 2. Принять (побеждает первая заявка)
curl -X POST -H "Authorization: Bearer sit_rk_..." \
  -H "Idempotency-Key: claim-7f3a" \
  "https://<host>/api/robotics/v1/serving-tasks/42/claim/"

# 3. Дождитесь, пока сотрудник загрузит поднос (задача перейдёт в `loaded`), затем отчитайтесь
curl -X POST -H "Authorization: Bearer sit_rk_..." \
  -H "Idempotency-Key: report-7f3a-1" \
  -H "Content-Type: application/json" \
  -d '{"status": "en_route"}' \
  "https://<host>/api/robotics/v1/serving-tasks/42/report/"

Отчёты идут en_route → arrived → completed; полный жизненный цикл см. в задачах подачи, а контракт ETag и повторов — в опросе и идемпотентности. Всё это время отправляйте heartbeat примерно каждые 30 секунд — устаревший heartbeat тихо останавливает предложения.

Набор проверок соответствия

Сертификация зарабатывается в песочнице: набор проверок прогоняет пять сценариев ниже через живой API, а Sitora записывает успешный прогон как артефакт вашей сертификации.

Сценарий	Что доказывает
claim_before_expiry	Вы принимаете предложения вовремя и корректно обрабатываете гонку заявок.
idempotent_duplicate_reports	Повторные отчёты с тем же Idempotency-Key воспроизводятся, а не применяются заново.
mid_route_failure_reporting	Сбои сообщаются с кодированной причиной, и заказ чисто возвращается к людям.
heartbeat_loss_and_recovery	Устаревший heartbeat останавливает предложения; восстановление происходит автоматически при следующем сигнале.
kill_switch_compliance	Приостановленный или замороженный филиал отказывает в заявках, и ваш контроллер немедленно подчиняется.

Все пять сценариев должны пройти; записанный прогон Sitora прикрепляет к сертификации поставщика. Сертификация проходится заново при объявленных по контракту ломающих изменениях контроллера.