Обновление координат полигона

POST /v1/polygon/coordinates/update

POST/v1/polygon/coordinates/update

Тело запроса

polygon_id
string
Идентификатор полигона.
coordinates
array
Контур полигона в формате RFC 7946: массив линейных колец В JSON передаётся как массив линейных колец: первое кольцо — внешняя граница, последующие — отверстия. Позиция задаётся как [долгота(longitude), широта(latitude)] в градусах, система координат WGS 84 (долгота первой компонентой). Пример: [[[37.61, 55.75], [37.62, 55.76]], [[37.70, 55.80], [37.71, 55.81]]].
Линейное кольцо (LinearRing).

Успешный ответ

200A successful response.
application/json
object
polygon_id
string
Идентификатор полигона.
errors
array
Ошибки валидации по полям; пустой массив при успехе. Коды только из PolygonCoordinatesValidationErrorCode.
Ошибка валидации/бизнеса поля для scope «PolygonCoordinates». Допустимые field: polygon_id, coordinates. Для бизнес-правил витрины: code=STOREFRONT_RULE_VIOLATION.
Показать свойства
field
string
required
Путь к полю. Ожидаемые: polygon_id, coordinates.
code
string
required
Коды ошибок ручки (scope PolygonCoordinates). Допустимые field: polygon_id, coordinates. - REQUIRED: Поле отсутствует или пустое, но обязательно - INVALID_TYPE: Неверный JSON-тип - INVALID_FORMAT: Общий сбой формата значения - NOT_FOUND: Сущность не найдена (уточняется полем field) - INVALID_COORDINATES: Некорректная геометрия / GeoJSON - RING_TOO_SHORT: LinearRing короче 4 позиций - RING_NOT_CLOSED: Кольцо не замкнуто - POSITION_SIZE: Позиция не 2–3 числа - INVALID_LATITUDE: Широта вне диапазона - INVALID_LONGITUDE: Долгота вне диапазона - STOREFRONT_RULE_VIOLATION: Запрос синтаксически валиден, но отклонён бизнес-правилом витрины (детали в message)
Допустимые значения
REQUIREDINVALID_TYPEINVALID_FORMATNOT_FOUNDINVALID_COORDINATESRING_TOO_SHORTRING_NOT_CLOSEDPOSITION_SIZEINVALID_LATITUDEINVALID_LONGITUDESTOREFRONT_RULE_VIOLATION
message
string
required
Текст для клиента. Для STOREFRONT_RULE_VIOLATION — описание правила.

Ошибки

400Некорректный запрос
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
401Ошибка авторизации
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
429Превышен лимит запросов
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
500Внутренняя ошибка сервера
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
defaultОшибка (неожиданная или прочие)
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
POST/v1/polygon/coordinates/update
1curl https://api.omninet.ru/v1/polygon/coordinates/update \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "polygon_id": "string",6  "coordinates": [7    [8      [9        100,10        011      ],12      [13        101,14        015      ],16      [17        101,18        119      ],20      [21        100,22        123      ],24      [25        100,26        027      ]28    ]29  ]30}'
{
  "polygon_id": "string",
  "errors": [
    {
      "field": "coordinates",
      "code": "RING_NOT_CLOSED",
      "message": "Кольцо полигона не замкнуто"
    }
  ]
}

A successful response.