Все примеры запросов в этой инструкции в формате Php для использования методом cURL в PHP
Перед тем как отправить запрос Вам необходимо пройти авторизацию.
Авторизация происходит методом Basic, где логин - публичный ключ, а пароль - secret ключ.
При этом заголовок Accept необходимо сохранить.
Информацию о ваших API ключах можете найти здесь
Перед тем как отправить запрос к калькулятору, необходимо предварительно знать отправителя(sender) и место(locality), кем и куда будем отправлять заказ -> из метода /api/delivery-services/senders и /api/locations/localities -> по инструкции вставить ссылку ( или соответствующего раздела в интерфейсе).
Например:
1. Нам необходим id отправителя с названием "Основной аккаунт (ООО "НоВиКо")":
Итоговый URL: https://cdek.orderadmin.ru/api/delivery-services/senders?filter[0][type]=ilike&filter[0][field]=name&filter[0][value]=%Новико%
В ответ получаем результат поиска с отправителями, у которых есть "Новико" в имени:
- отправитель "Основной аккаунт (ООО "НоВиКо")" с id = 139
2. Поиск id местоположения. Например, нам необходимо id села Дальнее, Сахалинская область
В ответ получаем все активные местоположения с названием Дальнее (наше местоположение с id = 189634)
3. Запросу для расчета стоимости доставки
Используем метод запроса POST
Request URL: https://cdek.orderadmin.ru/api/delivery-services/calculator -> Калькулятор работает обращаясь напрямую к API
параметр 'from' => 'От' система берет из Отправителя
Получаем ответ:
Если калькулятор не находит местоположение, то возвращает ошибку
Все методы работают по одному принципу:
GET без ID - список сущностей (например, все службы доставки: https://cdek.orderadmin.ru/api/delivery-services)
GET с ID - одна сущность со встроенными под сущностями
POST - создание
PATCH - обновление
3. В каком формате нужно передавать weight?
- Граммы;
4. В каком формате нужно передавать единицы измерения?
- Миллиметры;
5. Что означают payment и estimatedCost?
- payment - наложенный платеж, estimatedCost - оценочная стоимость;
6. Что нужно передать в поле "debug" для включения отладки? И что будет в отладочной информации?
- Отключается многопоточный калькулятор, если передать true, еще можно увидеть причину отсутствия расчета;
7. Как будут отличаться результаты расчета, если не передать все или какие-то конкретные необязательные поля?
- Расчет будет не точным или, если параметр критичный, его вообще не будет;
8. Почему поле "from" необязательное?
- Потому что данные поля можно указать в "sender" (как в примере выше);
9. В каком формате нужно заполнять информацию в поле "from"?
- В таком же как и "to", в вашем случае лучше указать отправителя.
10. Возможно ли определение адреса получателя по почтовому индексу?
- Наша система по индексу может определить город, но не более, т.к. вокруг почтового отделения масса улиц может быть и еще больше домов.
Поддержка | VK | Telegram | Сайт | Оцените нашу работу
Статья помогла?
Отлично!
Спасибо за ваш отзыв
Извините, что не удалось помочь!
Спасибо за ваш отзыв
Комментарий отправлен
Мы ценим вашу помощь и постараемся исправить статью