Склады

Эндпоинты для получения информации о складах компании.

Получение списка складов

Получить список всех складов, привязанных к компании.

Запрос

GET /depots

Заголовки:

X-API-Key: ваш_api_ключ

Ответ

{
  "ok": true,
  "result": [
    {
      "number": "14",
      "address": "г. Тюмень, ул. Ленина, 10",
      "lat": 57.153033,
      "lon": 65.534328,
      "time_interval_start": "08:00",
      "time_interval_finish": "18:00",
      "time_zone": "Asia/Yekaterinburg",
      "service_duration_s": 1800,
      "finish_service_duration_s": 300,
      "dock_capacity": 2,
      "full_refund": true,
      "reloading": false,
      "callbacks_url": null,
      "city_name": "Тюмень"
    }
  ]
}

Пример использования

cURL

curl -X GET "https://api.razvezu.pro/integration/v2/depots" \
  -H "X-API-Key: ваш_api_ключ"

JavaScript

const response = await fetch('https://api.razvezu.pro/integration/v2/depots', {
  headers: {
    'X-API-Key': 'ваш_api_ключ'
  }
});

const data = await response.json();
console.log(data.result);

Python

import requests

headers = {
    'X-API-Key': 'ваш_api_ключ'
}

response = requests.get(
    'https://api.razvezu.pro/integration/v2/depots',
    headers=headers
)

data = response.json()
print(data['result'])

---

Получение информации о складе

Получить детальную информацию о конкретном складе по его номеру.

Запрос

GET /depots/{number}

Параметры пути:

• number (string, required) — номер склада

Заголовки:

X-API-Key: ваш_api_ключ

Ответ

{
  "ok": true,
  "result": {
    "number": "14",
    "address": "г. Тюмень, ул. Ленина, 10",
    "lat": 57.153033,
    "lon": 65.534328,
    "time_interval_start": "08:00",
    "time_interval_finish": "18:00",
    "time_zone": "Asia/Yekaterinburg",
    "service_duration_s": 1800,
    "finish_service_duration_s": 300,
    "dock_capacity": 2,
    "full_refund": true,
    "reloading": false,
    "callbacks_url": "https://api.ru/status",
    "city_name": "Тюмень"
  }
}

Описание полей

Поле	Тип	Описание
number	string	Номер склада
address	string	Адрес склада
lat	float	Географическая широта
lon	float	Географическая долгота
time_interval_start	string	Время начала работы (HH:mm)
time_interval_finish	string	Время окончания работы (HH:mm)
time_zone	string	Часовой пояс склада
service_duration_s	integer	Время на погрузку в секундах
finish_service_duration_s	integer	Время на выгрузку в секундах
dock_capacity	integer	Пропускная способность склада
full_refund	boolean	Единовременный возврат
reloading	boolean	Возможность дозагрузки
callbacks_url	string | null	URL для колбеков
city_name	string	Название города

Примеры использования

cURL

curl -X GET "https://api.razvezu.pro/integration/v2/depots/14" \
  -H "X-API-Key: ваш_api_ключ"

JavaScript

const response = await fetch('https://api.razvezu.pro/integration/v2/depots/14', {
  headers: {
    'X-API-Key': 'ваш_api_ключ'
  }
});

const data = await response.json();
console.log(data.result);

Python

import requests

headers = {
    'X-API-Key': 'ваш_api_ключ'
}

response = requests.get(
    'https://api.razvezu.pro/integration/v2/depots/14',
    headers=headers
)

data = response.json()
print(data['result'])

Ошибки

404 Not Found

Склад не найден:

{
  "ok": false,
  "errors": {
    "message": "Склад не найден"
  }
}

401 Unauthorized

Ошибка аутентификации:

{
  "ok": false,
  "errors": {
    "message": "Неверные данные аутентификации"
  }
}

500 Internal Server Error

Внутренняя ошибка сервера:

{
  "ok": false,
  "errors": {
    "message": "Ошибка на стороне сервера, попробуйте позже"
  }
}