Документация API
Единый API расчёта доставки: от первого запроса до обработки ошибок и выбора перевозчиков.
Один запрос — несколько служб доставки
Доставометр получает ориентировочную стоимость и сроки через официальные API перевозчиков. Ваш сервер передаёт города, индексы и параметры посылки, а получает тарифы в едином формате.
Базовый адрес: https://api.dostavometr.ru/v1/. API использует JSON, HTTPS и Bearer-аутентификацию. Все методы относятся к версии v1.
| Метод | Назначение | Списание |
|---|---|---|
POST /v1/rates | Стоимость и сроки доставки | 1 запрос |
GET /v1/balance | Текущий баланс | Бесплатно |
GET /v1/carriers | Перевозчики и доступность | Бесплатно |
Технический сбой всех служб возвращает запрос на баланс. Корректный расчёт без тарифов списывает запрос. Подробнее — ошибки и повторные запросы.
С чего начать
- Создайте аккаунт и подтвердите email — это даст 100 бесплатных запросов.
- В кабинете создайте API-ключ и сохраните его в секретах своего сервера.
- Повторите пример первого расчёта.
Совместимость версий
Несовместимые изменения появятся в новой версии API. В v1 могут добавляться необязательные поля: разбирайте известные поля и допускайте новые.
Стоимость и сроки являются расчётными. Фактическая стоимость может отличаться от расчётной в зависимости от условий перевозчика, характеристик груза и договора отправителя. Доставометр не является перевозчиком, не заключает договор перевозки, не принимает груз и не отвечает за фактический срок доставки.