Получение профиля водителя (курьера)

Получение профиля водителя (курьера)

Request

GET

https://fleet-api.taxi.yandex.net/v2/parks/contractors/driver-profile

Query parameters

Name

Description

contractor_profile_id

Type: string

Идентификатор профиля водителя

Example: 9b17db0cb1f24a38a5c3c8b4f6e4f63b

Headers

Name

Description

X-API-Key

Type: string

API-ключ

Min length: 1

Example: <API-ключ>

X-Client-ID

Type: string

Идентификатор клиента

Min length: 1

Example: <Идентификатор клиента>

X-Park-ID

Type: string

Идентификатор партнера

Example: ee6f33c4562b4e1f8646d157bd70b2c4

Responses

200 OK

Получение профиля водителя (курьера)

Body

application/json
{
  "account": {
    "balance_limit": "50",
    "work_rule_id": "bc43tre6ba054dfdb7143ckfgvcby63e",
    "payment_service_id": "12345",
    "block_orders_on_balance_below_limit": true
  },
  "person": {
    "full_name": {
      "first_name": "Ivan",
      "middle_name": "Ivanovich",
      "last_name": "Ivanov"
    },
    "contact_info": {
      "address": "Moscow, Ivanovskaya Ul., bld. 40/2, appt. 63",
      "email": "example-email@example.com",
      "phone": "+79999999999"
    },
    "driver_license": {
      "birth_date": "1975-10-28",
      "country": "rus",
      "expiry_date": "2050-10-28",
      "issue_date": "2020-10-28",
      "number": "070236"
    },
    "driver_license_experience": {
      "total_since_date": "1970-01-01"
    },
    "tax_identification_number": "7743013902",
    "employment_type": "selfemployed"
  },
  "profile": {
    "hire_date": "2020-10-28",
    "work_status": "working",
    "fire_date": "2020-10-28",
    "comment": "great driver",
    "feedback": "great driver"
  },
  "car_id": "5011ade6ba054dfdb7143c8cc9460dbc",
  "order_provider": {
    "platform": true,
    "partner": true
  }
}

Name

Description

account

Type: AccountOptional

Учетная запись водителя

Example
{
  "balance_limit": "50",
  "work_rule_id": "bc43tre6ba054dfdb7143ckfgvcby63e",
  "payment_service_id": "12345",
  "block_orders_on_balance_below_limit": true
}

order_provider

Type: OrderProvider

Example
{
  "platform": true,
  "partner": true
}

person

Type: PersonOptional

Персональные данные водителя

Example
{
  "full_name": {
    "first_name": "Ivan",
    "middle_name": "Ivanovich",
    "last_name": "Ivanov"
  },
  "contact_info": {
    "address": "Moscow, Ivanovskaya Ul., bld. 40/2, appt. 63",
    "email": "example-email@example.com",
    "phone": "+79999999999"
  },
  "driver_license": {
    "birth_date": "1975-10-28",
    "country": "rus",
    "expiry_date": "2050-10-28",
    "issue_date": "2020-10-28",
    "number": "070236"
  },
  "driver_license_experience": {
    "total_since_date": "1970-01-01"
  },
  "tax_identification_number": "7743013902",
  "employment_type": "selfemployed"
}

profile

Type: ProfileOptional

Example
{
  "hire_date": "2020-10-28",
  "work_status": "working",
  "fire_date": "2020-10-28",
  "comment": "great driver",
  "feedback": "great driver"
}

car_id

Type: CarId

Идентификатор автомобиля

Min length: 1

Max length: 100

Example: 5011ade6ba054dfdb7143c8cc9460dbc

BalanceLimit

Лимит по счету

Type: string

Example: 50

WorkRuleId

Идентификатор условия работы

Type: string

Example: bc43tre6ba054dfdb7143ckfgvcby63e

PaymentServiceIdUpdate

ID для платежа

Type: string

Example: 12345

BlockOrdersOnBalanceBelowLimit

Запрещены ли все заказы при балансе ниже лимита

Type: boolean

AccountOptional

Учетная запись водителя

Name

Description

balance_limit

Type: BalanceLimit

Лимит по счету

Example: 50

block_orders_on_balance_below_limit

Type: BlockOrdersOnBalanceBelowLimit

Запрещены ли все заказы при балансе ниже лимита

Example: true

payment_service_id

Type: PaymentServiceIdUpdate

ID для платежа

Example: 12345

work_rule_id

Type: WorkRuleId

Идентификатор условия работы

Example: bc43tre6ba054dfdb7143ckfgvcby63e

Example
{
  "balance_limit": "50",
  "work_rule_id": "bc43tre6ba054dfdb7143ckfgvcby63e",
  "payment_service_id": "12345",
  "block_orders_on_balance_below_limit": true
}

FirstName

Имя

Type: string

Example: Ivan

MiddleName

Отчество

Type: string

Example: Ivanovich

LastName

Фамилия

Type: string

Example: Ivanov

FullNameOptional

Полное имя водителя

Name

Description

first_name

Type: FirstName

Имя

Example: Ivan

last_name

Type: LastName

Фамилия

Example: Ivanov

middle_name

Type: MiddleName

Отчество

Example: Ivanovich

Example
{
  "first_name": "Ivan",
  "middle_name": "Ivanovich",
  "last_name": "Ivanov"
}

Address

Адрес

Type: string

Example: Moscow, Ivanovskaya Ul., bld. 40/2, appt. 63

Email

Электронная почта

Type: string

Example: example-email@example.com

Phone

Номер телефона

Type: string

Pattern: ^\+\d{1,15}$

Example: +79999999999

ContactInfoOptional

Контактная информация водителя

Name

Description

address

Type: Address

Адрес

Example: Moscow, Ivanovskaya Ul., bld. 40/2, appt. 63

email

Type: Email

Электронная почта

Example: example-email@example.com

phone

Type: Phone

Номер телефона

Pattern: ^\+\d{1,15}$

Example: +79999999999

Example
{
  "address": "Moscow, Ivanovskaya Ul., bld. 40/2, appt. 63",
  "email": "example-email@example.com",
  "phone": "+79999999999"
}

BirthDate

Дата рождения в формате ISO 8601 без временной зоны

Type: string

Example: 1975-10-28

CountryCode

Страна выдачи водительского удостоверения (Трехбуквенный код)

Type: string

Example: rus

ExpiryDate

Дата окончания действия водительского удостоверения в формате ISO 8601 без временной зоны

Type: string

Example: 2050-10-28

IssueDate

Дата выдачи водительского удостоверения в формате ISO 8601 без временной зоны

Type: string

Example: 2020-10-28

Number

Серия и номер водительского удостоверения

Type: string

Example: 070236

DriverLicenseOptional

Информация o водительском удостоверении

Name

Description

birth_date

Type: BirthDate

Дата рождения в формате ISO 8601 без временной зоны

Example: 1975-10-28

country

Type: CountryCode

Страна выдачи водительского удостоверения (Трехбуквенный код)

Example: rus

expiry_date

Type: ExpiryDate

Дата окончания действия водительского удостоверения в формате ISO 8601 без временной зоны

Example: 2050-10-28

issue_date

Type: IssueDate

Дата выдачи водительского удостоверения в формате ISO 8601 без временной зоны

Example: 2020-10-28

number

Type: Number

Серия и номер водительского удостоверения

Example: 070236

Example
{
  "birth_date": "1975-10-28",
  "country": "rus",
  "expiry_date": "2050-10-28",
  "issue_date": "2020-10-28",
  "number": "070236"
}

Date

Дата в формате ISO 8601 без временной зоны

Type: string

Example: 1970-01-01

DriverLicenseExperience

Водительский стаж c

Name

Description

total_since_date

Type: Date

Дата в формате ISO 8601 без временной зоны

Example: 1970-01-01

Example
{
  "total_since_date": "1970-01-01"
}

TaxIdentificationNumber

Идентификационный номер налогоплательщика

Type: string

Min length: 1

Example: 7743013902

EmploymentType

Тип занятости водителя. Допустимые значения:

  • selfemployed — Парковый самозанятый;
  • park_employee — Парковый исполнитель;
  • individual_entrepreneur — Индивидуальный предприниматель;

Type: string

Enum: selfemployed, park_employee, individual_entrepreneur

PersonOptional

Персональные данные водителя

Name

Description

contact_info

Type: ContactInfoOptional

Контактная информация водителя

Example
{
  "address": "Moscow, Ivanovskaya Ul., bld. 40/2, appt. 63",
  "email": "example-email@example.com",
  "phone": "+79999999999"
}

driver_license

Type: DriverLicenseOptional

Информация o водительском удостоверении

Example
{
  "birth_date": "1975-10-28",
  "country": "rus",
  "expiry_date": "2050-10-28",
  "issue_date": "2020-10-28",
  "number": "070236"
}

driver_license_experience

Type: DriverLicenseExperience

Водительский стаж c

Example
{
  "total_since_date": "1970-01-01"
}

employment_type

Type: EmploymentType

Тип занятости водителя. Допустимые значения:

  • selfemployed — Парковый самозанятый;
  • park_employee — Парковый исполнитель;
  • individual_entrepreneur — Индивидуальный предприниматель;

Enum: selfemployed, park_employee, individual_entrepreneur

full_name

Type: FullNameOptional

Полное имя водителя

Example
{
  "first_name": "Ivan",
  "middle_name": "Ivanovich",
  "last_name": "Ivanov"
}

tax_identification_number

Type: TaxIdentificationNumber

Идентификационный номер налогоплательщика

Min length: 1

Example: 7743013902

Example
{
  "full_name": {
    "first_name": "Ivan",
    "middle_name": "Ivanovich",
    "last_name": "Ivanov"
  },
  "contact_info": {
    "address": "Moscow, Ivanovskaya Ul., bld. 40/2, appt. 63",
    "email": "example-email@example.com",
    "phone": "+79999999999"
  },
  "driver_license": {
    "birth_date": "1975-10-28",
    "country": "rus",
    "expiry_date": "2050-10-28",
    "issue_date": "2020-10-28",
    "number": "070236"
  },
  "driver_license_experience": {
    "total_since_date": "1970-01-01"
  },
  "tax_identification_number": "7743013902",
  "employment_type": "selfemployed"
}

HireDate

Дата приема в парк в формате ISO 8601 без временной зоны

Type: string

Example: 2020-10-28

WorkStatus

Статус работы водителя. Допустимые значения:

  • working — статус "Работает".
  • not_working — статус "Не работает";
  • fired — статус "Уволен";

Type: string

Enum: working, not_working, fired

FireDate

Дата увольнения из парка в формате ISO 8601 без временной зоны

Type: string

Example: 2020-10-28

Comment

Прочее

Type: string

Example: great driver

FeedBack

Прочее (доступно сотрудникам парка)

Type: string

Example: great driver

ProfileOptional

Name

Description

comment

Type: Comment

Прочее

Example: great driver

feedback

Type: FeedBack

Прочее (доступно сотрудникам парка)

Example: great driver

fire_date

Type: FireDate

Дата увольнения из парка в формате ISO 8601 без временной зоны

Example: 2020-10-28

hire_date

Type: HireDate

Дата приема в парк в формате ISO 8601 без временной зоны

Example: 2020-10-28

work_status

Type: WorkStatus

Статус работы водителя. Допустимые значения:

  • working — статус "Работает".
  • not_working — статус "Не работает";
  • fired — статус "Уволен";

Enum: working, not_working, fired

Example
{
  "hire_date": "2020-10-28",
  "work_status": "working",
  "fire_date": "2020-10-28",
  "comment": "great driver",
  "feedback": "great driver"
}

CarId

Идентификатор автомобиля

Type: string

Min length: 1

Max length: 100

Example: 5011ade6ba054dfdb7143c8cc9460dbc

Platform

Доступны ли заказы от платформы

Type: boolean

Partner

Доступны ли заказы от партнера

Type: boolean

OrderProvider

Name

Description

partner

Type: Partner

Доступны ли заказы от партнера

Example: true

platform

Type: Platform

Доступны ли заказы от платформы

Example: true

Example
{
  "platform": true,
  "partner": true
}

401 Unauthorized

Отсутствуют параметры авторизации запроса

Body

application/json
{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

403 Forbidden

Недостаточно прав для выполнения запроса

Body

application/json
{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

404 Not Found

Запрашиваемый ресурс не найден

Body

application/json
{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

429 Too Many Requests

Превышено допустимое число запросов

Body

application/json
{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

500 Internal Server Error

Внутренняя ошибка сервера

Body

application/json
{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

No longer supported, please use an alternative and newer version.