Лимиты и баланс — Доставометр

Частота запросов

Лимит применяется к аккаунту, а не к отдельному ключу. По умолчанию бесплатный аккаунт может выполнять до 2 запросов в секунду с коротким burst до 5; после первой покупки — 10 в секунду с burst до 20. Индивидуальные лимиты могут быть заданы администратором.

При превышении сервер вернёт HTTP 429 с rate_limit_exceeded и заголовком Retry-After. Уменьшите параллелизм и повторите после указанной задержки. Ограничение касается POST /rates и бесплатных GET-методов.

GET /v1/balance

Возвращает оставшееся количество API-запросов. Не списывает запросы.

{"balance": 100}

Пример ответа. Фактический баланс относится к вашему аккаунту.

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

curl --fail-with-body https://api.dostavometr.ru/v1/balance \
  -H "Authorization: Bearer $DOSTAVOMETR_API_KEY"

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

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://api.dostavometr.ru/v1/balance",
    headers={
        "Authorization": "Bearer " + os.environ["DOSTAVOMETR_API_KEY"],
    },
)
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/balance');
$options = [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $key, 'Content-Type: application/json'],
];
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/balance', {
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  signal: AbortSignal.timeout(30000),
});
const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);

Как экономить вызовы

Получайте баланс из balance_remaining в ответе расчёта, а не запрашивайте его перед каждым POST. Выбирайте только нужных перевозчиков. Для повторной операции используйте Idempotency-Key.

Когда пополнить баланс

В настройках можно включить уведомление и выбрать порог 100, 500, 1 000 запросов либо автоматические 10% последнего купленного пакета.

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