Изменение списка к Групп в которые входит ТС.
Заменяет текущий список на новый.
Запрос:
URL:
PATCH https://api.url/v2.1/user/<user_id>/cars/<car_id>/relationships/Groups
Доп. Заголовки:
Accept - для указания формата ответа. Должен быть "application/vnd.api+json", для совместимости принимается также "application/json".
Content-Type - для указания формата ответа. Должен быть "application/vnd.api+json".
Authorization - для передачи токена. Передается в формате: Bearer <access_token>.
Данные запроса:
Запрос отсылается в формате JSON API.
Поле | Описание | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
data | Содержит список ссылок в формате JSON API Каждый объект содержит
|
Ответ:
Ответ присылается в формате JSON API.
Поле | Описание | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
links | Поле links содержит ссылки на ресурсы. Минимально он должен содержать ссылку на текущий ресурс (self). | |||||||||
meta | Содержит total_count - количество групп в которые входит ТС. | |||||||||
data | Содержит массив ссылок в формате JSON API. Каждый объект содержит:
|
Коды ответов:
200 ОК - Сервер обработал запрос. В теле ответа содержится текущий список групп.
401 Unauthorized - не передан заголовок Authorization, либо токен не корректный либо истёк срок действия токена.
403 Forbidden - нет прав на данной тс.
404 Not Found - ТС не найдена или группа не найдены.
400 Bad Request - Переданы не поддерживаемые параметры либо сервер не понял запрос (описание ошибки в теле ответа).
Также возможны другие ошибки.
Пример
PATCH https://api.url/v2.1/user/1/cars/1/relationships/Groups HTTP/1.1 Accept: application/vnd.api+json Content-Type: application/vnd.api+json Authorization: Bearer <auth token> { "data": [ { "type": "group", "id": "1" }, { "type": "group", "id": "2" }, { "type": "group", "id": "3" }, { "type": "group", "id": "4" } ] } HTTP/1.1 200 OK Content-Type: application/vnd.api+json { "links": { "self": "http://api.url/v2.1/user/1/cars/1/relationships/Groups" }, "meta":{ "total_count": 4 }, "data": [ { "type": "group", "id": "1" }, { "type": "group", "id": "2" }, { "type": "group", "id": "3" }, { "type": "group", "id": "4" } ] }