Создание водителя¶

Создание водителя

Запрос (Request)¶

POST-запрос¶

https://sedi.ru:9031/api/SeDiExternalSystems/driver-profile/

Заголовки (Headers)¶

Название	Описание
X-Api-Key	API-ключ
X-Client-ID	Ключ, определяющий партнера

Параметры¶

Название	Описание
person	Персональные данные водителя. Тип: Person
car_id	Идентификатор машины, к которой будет привязан водитель. Идентификатор, полученный ранее при создании машины car.

Person¶

Название	Описание
contact_info	Контактные данные водителя. Тип: ContactInfo
driver_license	Информация по водительскому удостоверению. Тип: DriverLicense
full_name	ФИО водителя. Тип: FullName
tax_identification_number	ИНН водителя. Тип: `String`

ContactInfo¶

Название	Описание
phone	Номер телефона. Тип: `String`
address	Адрес. Тип: `String`
email	Электронная почта. Тип: `String`

DriverLicense¶

Название	Описание
number	Серия и номер водительского удостоверения. Тип: `String`
issue_date	Дата выдачи водительского удостоверения. Тип: `String`
expiry_date	Дата окончания действия водительского удостоверения. Тип: `String`

FullName¶

Название	Описание
first_name	Имя. Тип: `String`
last_name	Фамилия. Тип: `String`
middle_name	Отчество. Тип: `String`

Пример тела запроса¶

{
    "person": {
        "full_name": {
            "first_name": "Иванов",
            "middle_name": "Сергеевич",
            "last_name": "Петр"
        },
        "contact_info": {
            "address": "Москва, Ивантеевская улица 8",
            "email": "iv@mail.ru",
            "phone": "+79030160000"
        },
        "driver_license": {
            "expiry_date": "2030-02-25",
            "issue_date": "2020-02-25",
            "number": "070707"
        },
        "tax_identification_number": "7788990044"
    },
    "car_id": "7517399"
}

Ответ¶

200 OK¶

Водитель создан успешно

{
  "contractor_profile_id": "123" // ID созданного водителя
}

403 Forbidden¶

Некорректный API KEY.

400 BadRequest¶

Некорректные параметры запроса или пустые заголовки.

500 InternalServerError¶

Ошибка в процессе выполнения запроса

Error. Ошибка добавления¶

{
  "code": "код ошибки",
  "message": "текстовое описание ошибки"
}