Получает справочник публичных зон

  1. HTTP-запрос
  2. Query-параметры
  3. Ответы
    1. Код 200
      1. Представление
      2. Поля
    2. Код 401
    3. Код 403
    4. Код 422

Получает справочник публичных зон.

HTTP-запрос

GET https://courier.yandex.ru/api/v1/reference-book/public/zones\
?apikey={string}\
&page={integer}\
&per_page={integer}

Query-параметры

apikey

string

API-ключ компании.

page

integer

Номер страницы в базе данных. Каждая страница содержит per_page публичных зон, упорядоченных по возрастанию ID курьера.

Минимальное значение: 1.
Значение по умолчанию: 1.

per_page

integer

Количество публичных зон на страницу.

Минимальное значение: 1.
Максимальное значение: 50.
Значение по умолчанию: 10.

apikey

string

API-ключ компании.

page

integer

Номер страницы в базе данных. Каждая страница содержит per_page публичных зон, упорядоченных по возрастанию ID курьера.

Минимальное значение: 1.
Значение по умолчанию: 1.

per_page

integer

Количество публичных зон на страницу.

Минимальное значение: 1.
Максимальное значение: 50.
Значение по умолчанию: 10.

Ответы

Код 200

Справочник публичных зон получен.

[
  {
    "color_edge": string,
    "color_fill": string,
    "id": string,
    "number": string,
    "polygon": {
      "coordinates": [
        "array"
      ],
      "type": string
    }
  }
]
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

color_edge

string

Цвет края зоны. Возможные форматы: #000000, rgb (0,0,0), black.

color_fill

string

Цвет заливки зоны. Возможные форматы: #000000, rgb (0,0,0), black.

id

string

ID зоны в справочнике.

number

string

Номер зоны.

polygon

object

Полигон зоны. Форматы: Geojson в соответствии со спецификацией RFC7946. Пример: {"type":"Polygon","coordinates":[[[0.0,0.0],[2.2,2.2],[-1.1,1.1],[0.0,0.0]]]}

polygon.coordinates[] *

array

polygon.type *

string

Всегда равен Polygon

color_edge

string

Цвет края зоны. Возможные форматы: #000000, rgb (0,0,0), black.

color_fill

string

Цвет заливки зоны. Возможные форматы: #000000, rgb (0,0,0), black.

id

string

ID зоны в справочнике.

number

string

Номер зоны.

polygon

object

Полигон зоны. Форматы: Geojson в соответствии со спецификацией RFC7946. Пример: {"type":"Polygon","coordinates":[[[0.0,0.0],[2.2,2.2],[-1.1,1.1],[0.0,0.0]]]}

polygon.coordinates[] *

array

polygon.type *

string

Всегда равен Polygon

Код 401

Ошибка авторизации. Убедитесь, что заголовок запроса содержит правильный OAuth-токен.

Код 403

У вас нет доступа к этому объекту.

Код 422

Неверный ввод. Операция не может быть выполнена.