API СДЭК: где взять ключи и как подключить интеграцию
API СДЭК нужен, когда готового модуля не хватает: свой сайт, мобильное приложение, учётная система или маркетплейс-агрегатор. Разбираем, как получить доступ, что проверить в тестовой среде и какие ошибки чаще всего ломают интеграцию.
Кратко
- Боевой ключ выдаётся только по договору — в разделе «Интеграции» личного кабинета.
- Для разработки есть тестовая среда с общедоступными тестовыми ключами: на ней можно всё отладить до договора.
- Ключ — это пароль от вашего кабинета. Держите его на сервере, не в коде страницы.
Что такое «сервис интеграции» и ключ
Ключ интеграции — пара значений: Account (идентификатор) и Secure password. По ним ваш сервер получает временный токен доступа и вызывает методы API от имени вашей компании: считает стоимость, создаёт заказы, запрашивает статусы.
Где взять: личный кабинет СДЭК → «Интеграции» → «Создать ключ». Ключ появляется только у компаний с договором — у ИП и ООО его можно получить в тот же день через онлайн-оферту (как подключить).
Тестовая и боевая среда
| Тестовая | Боевая | |
|---|---|---|
| Доступ | Общие тестовые ключи из документации СДЭК | Ваш ключ из кабинета |
| Договор | Не нужен | Нужен |
| Заказы | Учебные, никуда не едут | Настоящие отправления |
Типичная ошибка — оставить на сайте адрес тестовой среды после запуска: расчёт работает, а заказы в кабинете не появляются.
Какие методы нужны интернет-магазину
- Авторизация — получение токена по Account и Secure password. Токен живёт ограниченное время, его нужно обновлять.
- Расчёт стоимости по тарифам — для корзины сайта.
- Список пунктов выдачи — для карты ПВЗ.
- Создание заказа — после оплаты или подтверждения.
- Статусы заказа — чтобы показывать покупателю, где посылка.
- Печать накладных и этикеток.
- Вебхуки — СДЭК сам сообщает о смене статуса.
Полный перечень и форматы — в официальной документации API СДЭК.
Вебхуки: почему нельзя полагаться только на них
Вебхук — это уведомление «на ваш адрес». Если ваш сервер в этот момент был недоступен, уведомление может не дойти, а вы об этом не узнаете. То же касается заказов, которые сайт передаёт в службу доставки: конструкторы сайтов обычно не отправляют заявку повторно после сбоя.
Что делать:
- сверка раз в день: запросить статусы всех активных заказов и сравнить с базой;
- алерт на расхождение: если заказ есть на сайте, но не в СДЭК — уведомление в мессенджер;
- журнал ошибок API: сохранять ответы с ошибками, чтобы разбирать, а не гадать.
Частые ошибки
- Ключ в коде страницы. Любой посетитель может его увидеть и создать заказы от вашего имени. Запросы к API — только с сервера.
- Токен не обновляется. Через время все запросы начинают падать с ошибкой авторизации.
- Не те габариты и вес. Цена на сайте и при сдаче расходится. Передавайте реальные габариты.
- Нет проверки адреса. Опечатки в городе или индексе дают ошибки создания заказа — подсказывайте адрес при вводе.
Частые вопросы
API СДЭК платный? Доступ к API бесплатный, оплачиваются только сами отправления по вашему договору.
Можно ли разработчику начать без договора? Да, в тестовой среде. Для запуска магазина договор всё равно понадобится.
Есть ли готовые модули, чтобы не писать код? Да, для популярных платформ — см. интеграция СДЭК с сайтом и СДЭК для Тильды.