Запрос:
URL:
POST https://api.url/v2.1/user/<user_id>/drivers/<driver_id>/addresses
Доп. Заголовки:
Accept - для указания формата ответа. Должен быть "application/vnd.api+json"
Content-Type - "application/vnd.api+json".
Authorization - для передачи токена. Передается в формате: Bearer <access_token>.
Запрос присылается в формате JSON API.
Данные запроса:
Запрос отсылается в формате JSON API.
| Поле | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| data | Содержит объект в формате JSON API. Каждый объект содержит
|
Описание атрибутов.
| Поле | Тип | Nullable | Описание |
|---|---|---|---|
| Type | int | нет | тип адреса 0 - Юридический адрес 1 - Фактический адрес 2 - Адрес доставки |
Address | string | нет | Строка адреса |
Описание связанных объектов:
| Поле | Тип | Nullable | Описание |
|---|---|---|---|
| Driver | object<driver> | нет | Водитель к которому привязан адрес |
Коды ответов:
201 Created - Сервер обработал запрос. В теле ответа содержатся данные созданного объекта.
403 Forbidden - нет прав на создание.
404 Not Found - Водитель не найден.
400 Bad Request - Переданы неподдерживаемые параметры, либо сервер не понял запрос (описание ошибки в теле ответа).
Пример
POST https://api.url/v2.1/user/1/drivers/1/addresses HTTP/1.1
Accept: application/vnd.api+json
Authorization: Bearer <auth token>
{
"data": {
"type": "address",
"attributes": {
"Type": 0,
"Address": "Марксистская 34 к.8"
},
"relationships": {
"Driver": {
"data": {
"id": "1",
"type": "driver"
}
}
}
}
}
HTTP/1.1 201 Created
Content-Type: application/vnd.api+json
Location: https://api-test01.citypoint.ru/v2.1/user/1/drivers/1/addresses/1
{
"links": {
"self": "https://api-test01.citypoint.ru/v2.1/user/1/drivers/1/addresses/1"
},
"data": {
"id": "1",
"type": "address",
"attributes": {
"Type": 0,
"Address": "Марксистская 34 к.8"
},
"relationships": {
"Driver": {
"data": {
"id": "1",
"type": "driver"
}
}
}
}
}
}