Подключение системы

Раздел для разработчиков внешних систем — 1С, ERP, WMS, интернет-магазинов, — которые подключаются к платформе через публичный API.

Здесь описан полный путь: от выпуска ключа до получения готовых маршрутов и статусов доставки. Все контракты, коды ошибок и лимиты соответствуют текущей версии API.

С чего начать

Если вы подключаетесь впервые, читайте подряд первые три главы — они занимают около пятнадцати минут и закрывают большую часть типовых ошибок:

1. Быстрый старт — четыре шага минимального цикла интеграции.
2. Выпуск API-ключа — где взять ключ и что с ним нельзя делать.
3. Аутентификация — какой заголовок отправлять и почему не стоит отправлять оба сразу.

Остальные главы — справочные: открывайте нужную по мере необходимости.

Что стоит прочитать до запуска в работу

Две главы написаны по опыту реальных интеграций и экономят больше всего времени:

• Подводные камни — асинхронное геокодирование, формат адреса, неуникальный external_id, дата доставки по умолчанию.
• Лимиты и ошибки — ограничение частоты, коды ответов и правило поведения при таймауте.

Базовый адрес

В примерах используется условный адрес https://api.example.com. Подставьте адрес вашей установки — его сообщает администратор компании вместе с ключом. Пути после базового адреса (/api/public/v1/…), названия заголовков и полей приведены точно и подстановки не требуют.