Отправляет позиции курьеров в базу данных

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

Отправляет позиции курьеров в базу данных для отслеживания.

HTTP-запрос

POST https://courier.yandex.ru/api/v1/couriers/{courier_id}/routes/{route_id}/push-positions-v3\
?apikey={string}

Path-параметры

courier_id *

integer

ID курьера, используемый в запросах к API Мониторинга.

route_id *

integer

ID маршрута, используемый в запросах к API Мониторинга.

courier_id *

integer

ID курьера, используемый в запросах к API Мониторинга.

route_id *

integer

ID маршрута, используемый в запросах к API Мониторинга.

Query-параметры

apikey *

string

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

apikey *

string

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

Тело запроса

{
  "positions": [
    {
      "accuracy": integer,
      "heading": integer,
      "point": {
        "lat": number,
        "lon": number
      },
      "speed": number,
      "timestamp": integer
    }
  ]
}
Скопировано

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

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

Поля

positions[] *

array

positions[].accuracy *

integer

Точность GPS в метрах.

positions[].heading

integer

Направление, в градусах по отношению к северу. Ещё не поддержано.

positions[].point *

object

positions[].point.lat *

number

Широта точки.

positions[].point.lon *

number

Долгота точки.

positions[].speed

number

Мгновенная скорость. Ещё не поддержано.

positions[].timestamp *

integer

Время позиции курьера в UTC (в секундах).

Минимальное значение: 0.

positions[] *

array

positions[].accuracy *

integer

Точность GPS в метрах.

positions[].heading

integer

Направление, в градусах по отношению к северу. Ещё не поддержано.

positions[].point *

object

positions[].point.lat *

number

Широта точки.

positions[].point.lon *

number

Долгота точки.

positions[].speed

number

Мгновенная скорость. Ещё не поддержано.

positions[].timestamp *

integer

Время позиции курьера в UTC (в секундах).

Минимальное значение: 0.

Ответы

Код 200

Данные были сохранены.

Код 403

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

Код 404

Объект не найден.

Код 422

Неправильный ввод.