Первый расчёт доставки

1. Подтвердите email

Зарегистрируйтесь, перейдите по ссылке из письма и войдите в кабинет. После подтверждения на баланс однократно поступят 100 запросов.

2. Создайте API-ключ

Откройте API-ключи, задайте название и нажмите «Создать ключ». Полный секрет показывается один раз. Сохраните его в переменной окружения вашего сервера:

export DOSTAVOMETR_API_KEY='ваш_секретный_ключ'

Для PowerShell: $env:DOSTAVOMETR_API_KEY = 'ваш_секретный_ключ'. Не помещайте ключ в frontend-код, Git или URL.

3. Рассчитайте доставку

Ниже рабочие примеры для всех поддержанных языков. cURL использует переменную окружения в оболочке Bash. Python использует только стандартную библиотеку, PHP требует расширение cURL, JavaScript запускается на сервере в Node.js 20+.

cURLПример запроса

curl --fail-with-body https://api.dostavometr.ru/v1/rates \
  -H "Authorization: Bearer $DOSTAVOMETR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "from": {
    "country": "RU",
    "city": "Чита",
    "postal_code": "672000"
  },
  "to": {
    "country": "RU",
    "city": "Москва",
    "postal_code": "101000"
  },
  "parcel": {
    "weight_grams": 1000,
    "length_cm": 30,
    "width_cm": 20,
    "height_cm": 15
  }
}'

PythonПример запроса

import json
import os
import urllib.request

payload = {
  "from": {
    "country": "RU",
    "city": "Чита",
    "postal_code": "672000"
  },
  "to": {
    "country": "RU",
    "city": "Москва",
    "postal_code": "101000"
  },
  "parcel": {
    "weight_grams": 1000,
    "length_cm": 30,
    "width_cm": 20,
    "height_cm": 15
  }
}
request = urllib.request.Request(
    "https://api.dostavometr.ru/v1/rates",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["DOSTAVOMETR_API_KEY"],
        "Content-Type": "application/json",
    },
)
with urllib.request.urlopen(request, timeout=30) as response:
    print(json.load(response))

PHPПример запроса

<?php
$key = getenv('DOSTAVOMETR_API_KEY');
if (!$key) { throw new RuntimeException('Set DOSTAVOMETR_API_KEY'); }
$ch = curl_init('https://api.dostavometr.ru/v1/rates');
$options = [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $key, 'Content-Type: application/json'],
];
$payload = json_decode(<<<'JSON'
{
  "from": {
    "country": "RU",
    "city": "Чита",
    "postal_code": "672000"
  },
  "to": {
    "country": "RU",
    "city": "Москва",
    "postal_code": "101000"
  },
  "parcel": {
    "weight_grams": 1000,
    "length_cm": 30,
    "width_cm": 20,
    "height_cm": 15
  }
}
JSON, true, 512, JSON_THROW_ON_ERROR);
$options[CURLOPT_POST] = true;
$options[CURLOPT_POSTFIELDS] = json_encode($payload, JSON_THROW_ON_ERROR);
curl_setopt_array($ch, $options);
$body = curl_exec($ch);
if ($body === false) { throw new RuntimeException(curl_error($ch)); }
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status >= 400) { throw new RuntimeException($body); }
print_r(json_decode($body, true, 512, JSON_THROW_ON_ERROR));

JavaScriptПример запроса

// Node.js 20+; запускайте на сервере, чтобы не раскрыть API-ключ.
const apiKey = process.env.DOSTAVOMETR_API_KEY;
if (!apiKey) throw new Error('Set DOSTAVOMETR_API_KEY');
const response = await fetch('https://api.dostavometr.ru/v1/rates', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "from": {
    "country": "RU",
    "city": "Чита",
    "postal_code": "672000"
  },
  "to": {
    "country": "RU",
    "city": "Москва",
    "postal_code": "101000"
  },
  "parcel": {
    "weight_grams": 1000,
    "length_cm": 30,
    "width_cm": 20,
    "height_cm": 15
  }
}),
  signal: AbortSignal.timeout(30000),
});
const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);

4. Разберите результат

В rates находятся тарифы. price_kopecks — целое число копеек; 48 700 копеек = 487 ₽. days_min и days_max могут быть null, если перевозчик не сообщил сроки. В unavailable — службы, не давшие результата.

{
  "request_id": "req_example",
  "rates": [
    {
      "carrier": "russian_post",
      "carrier_name": "Почта России",
      "service_code": "parcel",
      "service_name": "Посылка",
      "delivery_type": "post_office",
      "price_kopecks": 48700,
      "currency": "RUB",
      "days_min": 5,
      "days_max": 7,
      "price_type": "public"
    }
  ],
  "unavailable": [
    {
      "carrier": "dellin",
      "reason": "not_configured"
    }
  ],
  "balance_remaining": 99
}

Пример формата. Значения цены, срока и статуса иллюстративные.

Баланс после успешного первого расчёта: 99 запросов. Сохраните request_id для диагностики.

Стоимость и сроки являются расчётными. Фактическая стоимость может отличаться от расчётной в зависимости от условий перевозчика, характеристик груза и договора отправителя. Доставометр не является перевозчиком, не заключает договор перевозки, не принимает груз и не отвечает за фактический срок доставки.