Песочница и запуск

Песочница

Песочница — это отдельная тестовая компания в Orda со своим ключом. Её данные никак не пересекаются с боевыми: изоляция компаний в Orda строгая (на уровне базы данных). В песочнице можно сколько угодно создавать, менять и отменять заказы, строить и утверждать маршруты, проверять вебхуки.

Как получить: напишите менеджеру Orda (контакты — на сайте), укажите название компании и e-mail технического специалиста. Вы получите код тестовой компании, вход администратора и API-ключ.

Совет: держите в учётной системе две настройки подключения — «Тест» и «Бой» (адрес, ключ, секрет вебхука) и переключайтесь между ними без правки кода.

Что проверить в песочнице

1. Ключ работает: GET /orders → 200.
2. Справочники: точки доставки и склады загружаются, повторная загрузка обновляет, а не дублирует.
3. Заказы: пакет из 100–1000 строк, в ответе нет неожиданных ошибок; повтор пакета → updated.
4. Ошибки обрабатываются: строки с result: "error" попадают в журнал вашей системы с кодом ошибки.
5. Повтор после обрыва: запрос с тем же Idempotency-Key не создаёт дублей.
6. Вебхуки: тестовое событие POST /webhooks/{id}/test доходит, подпись проверяется, ответ — 2xx за < 10 с.
7. Отмена заказа в учётной системе → status: "cancelled" в Orda.
8. Маршруты: план строится и утверждается; ваша система получает plan.approved.

Чек-лист запуска

• Боевой ключ выпущен от служебной учётной записи, хранится в хранилище секретов.
• У ключа только нужные права (без delete, если удаление не нужно).
• Адрес вебхука — https с действительным сертификатом, доступен из интернета.
• Подпись вебхуков проверяется, старые метки времени (> 5 минут) отклоняются.
• Повторы при 429 и 5xx — с паузой; Idempotency-Key на каждом изменении.
• Журнал обмена в вашей системе: что отправлено, что вернулось, какие строки с ошибкой.
• Назначен ответственный с вашей стороны и контакт поддержки Orda.