### GET /suggests/skill_set

Source: https://api.hh.ru/openapi/specification/public

API endpoint for GET /suggests/skill_set

```markdown
### Parameters

- **text** (string, query, required): Текст для поиска ключевых навыков. Искомый текст должен быть длиной два или более символа и не более 3 000 символов
- **host** (string (hh.ru|rabota.by|hh1.az|hh.uz|hh.kz|headhunter.ge|headhunter.kg), query, optional): Доменное имя сайта (см. [Выбор сайта](#section/Obshaya-informaciya/Vybor-sajta))

- **locale** (string, query, optional): Идентификатор локали (см. [Локализация](#tag/Obshie-spravochniki/operation/get-locales))

- **HH-User-Agent** (string, header, required): Название приложения и контактная почта разработчика (см. [Информация о клиенте](#section/Obshaya-informaciya/Trebovaniya-k-zaprosam))


### Responses

#### 200 - Успешный ответ

**SuggestsSkillSet**
- **items** (array (_IncludesSkillSetItem)) (required): Массив найденных ключевых навыков
  Array items:
    - **id** (string) (required): Идентификатор ключевого навыка
    - **text** (string) (required): Название ключевого навыка

#### 400 - Ошибки запроса

**SuggestsErrors**
- **request_id** (string) (required): Идентификатор запроса (example: "q1ww2e2r4ty")
- **bad_argument** (string (locale|text|area_id)) ("locale"|"text"|"area_id")
- **bad_arguments** (array (object))
  Array items:
    - **description** (string)
    - **name** (string (locale|text|area_id)): Поле, в котором допущена ошибка. 
Возможные значения:
* `locale` — указан неподдерживаемый язык
* `text` — искомый текст должен быть длиной от 2 до 30000 символов
* `area_id` - указан не валидный идентификатор
 ("locale"|"text"|"area_id")
- **description** (string)
- **errors** (array (object)) (required)
  Array items:
    - **type** (string (bad_argument)) ("bad_argument")
    - **value** (string (locale|text|area_id)): Поле, в котором допущена ошибка. 
Возможные значения:
* `locale` — указан неподдерживаемый язык
* `text` — искомый текст должен быть длиной от 2 до 30000 символов
* `area_id` - указан не валидный идентификатор
 ("locale"|"text"|"area_id")

### Example Usage

```bash
curl -X GET "https://api.hh.ru/suggests/skill_set?text=string&host=hh.ru&locale=RU"
```

```

--------------------------------

### GET /suggests/professional_roles

Source: https://api.hh.ru/openapi/specification/public

API endpoint for GET /suggests/professional_roles

```markdown
### Parameters

- **text** (string, query, required): Текст для поиска профессиональной роли. Искомый текст должен быть длиной два или более символа и не более 3 000 символов
- **host** (string (hh.ru|rabota.by|hh1.az|hh.uz|hh.kz|headhunter.ge|headhunter.kg), query, optional): Доменное имя сайта (см. [Выбор сайта](#section/Obshaya-informaciya/Vybor-sajta))

- **locale** (string, query, optional): Идентификатор локали (см. [Локализация](#tag/Obshie-spravochniki/operation/get-locales))

- **HH-User-Agent** (string, header, required): Название приложения и контактная почта разработчика (см. [Информация о клиенте](#section/Obshaya-informaciya/Trebovaniya-k-zaprosam))


### Responses

#### 200 - Успешный ответ

**SuggestsProfessionalRoles**
- **items** (array (SuggestsProfessionalRoleItem)) (required): Информация о найденных профессиональных ролях
  Array items:
    - **accept_incomplete_resumes** (boolean) (required): Профессиональная роль, для которой можно принимать отклики неполным резюме (example: true)
    - **id** (string) (required): Идентификатор профессиональной роли (example: "21")
    - **text** (string) (required): Название профессиональной роли (example: "Водитель")

#### 400 - Ошибки запроса

**SuggestsErrors**
- **request_id** (string) (required): Идентификатор запроса (example: "q1ww2e2r4ty")
- **bad_argument** (string (locale|text|area_id)) ("locale"|"text"|"area_id")
- **bad_arguments** (array (object))
  Array items:
    - **description** (string)
    - **name** (string (locale|text|area_id)): Поле, в котором допущена ошибка. 
Возможные значения:
* `locale` — указан неподдерживаемый язык
* `text` — искомый текст должен быть длиной от 2 до 30000 символов
* `area_id` - указан не валидный идентификатор
 ("locale"|"text"|"area_id")
- **description** (string)
- **errors** (array (object)) (required)
  Array items:
    - **type** (string (bad_argument)) ("bad_argument")
    - **value** (string (locale|text|area_id)): Поле, в котором допущена ошибка. 
Возможные значения:
* `locale` — указан неподдерживаемый язык
* `text` — искомый текст должен быть длиной от 2 до 30000 символов
* `area_id` - указан не валидный идентификатор
 ("locale"|"text"|"area_id")

### Example Usage

```bash
curl -X GET "https://api.hh.ru/suggests/professional_roles?text=string&host=hh.ru&locale=RU"
```

```

--------------------------------

### GET /suggests/positions

Source: https://api.hh.ru/openapi/specification/public

API endpoint for GET /suggests/positions

```markdown
### Parameters

- **text** (string, query, required): Текст для поиска должности. Искомый текст должен быть длиной два или более символа и не более 3 000 символов
- **host** (string (hh.ru|rabota.by|hh1.az|hh.uz|hh.kz|headhunter.ge|headhunter.kg), query, optional): Доменное имя сайта (см. [Выбор сайта](#section/Obshaya-informaciya/Vybor-sajta))

- **locale** (string, query, optional): Идентификатор локали (см. [Локализация](#tag/Obshie-spravochniki/operation/get-locales))

- **HH-User-Agent** (string, header, required): Название приложения и контактная почта разработчика (см. [Информация о клиенте](#section/Obshaya-informaciya/Trebovaniya-k-zaprosam))


### Responses

#### 200 - Успешный ответ

**SuggestsPositions**
- **items** (array (SuggestsPositionItem)) (required): Информация о найденных должностях
  Array items:
    - **id** (string) (required): Идентификатор должности (example: "2063")
    - **professional_roles** (array (SuggestsProfessionalRoleItemWithName)) (required): Информация о профессиональных ролях, соответствующих должности
      Array items:
        - **accept_incomplete_resumes** (boolean) (required): Профессиональная роль, для которой можно принимать отклики неполным резюме (example: true)
        - **id** (string) (required): Идентификатор профессиональной роли (example: "21")
        - **name** (string) (required): Название профессиональной роли (example: "Водитель")
    - **specializations** (array (SuggestsSpecializationsWithName)): Информация о специализациях, соответствующих должности
      Array items:
        - **id** (string) (required): Идентификатор специализации (example: "21.17")
        - **name** (string) (required): Название специализации (example: "Автоперевозки")
        - **profarea_id** (string) (required): Идентификатор профессиональной области (example: "21")
        - **profarea_name** (string) (required): Название профессиональной области (example: "Транспорт, логистика")
    - **text** (string) (required): Название должности (example: "Личный водитель")

#### 400 - Ошибки запроса

**SuggestsErrors**
- **request_id** (string) (required): Идентификатор запроса (example: "q1ww2e2r4ty")
- **bad_argument** (string (locale|text|area_id)) ("locale"|"text"|"area_id")
- **bad_arguments** (array (object))
  Array items:
    - **description** (string)
    - **name** (string (locale|text|area_id)): Поле, в котором допущена ошибка. 
Возможные значения:
* `locale` — указан неподдерживаемый язык
* `text` — искомый текст должен быть длиной от 2 до 30000 символов
* `area_id` - указан не валидный идентификатор
 ("locale"|"text"|"area_id")
- **description** (string)
- **errors** (array (object)) (required)
  Array items:
    - **type** (string (bad_argument)) ("bad_argument")
    - **value** (string (locale|text|area_id)): Поле, в котором допущена ошибка. 
Возможные значения:
* `locale` — указан неподдерживаемый язык
* `text` — искомый текст должен быть длиной от 2 до 30000 символов
* `area_id` - указан не валидный идентификатор
 ("locale"|"text"|"area_id")

### Example Usage

```bash
curl -X GET "https://api.hh.ru/suggests/positions?text=string&host=hh.ru&locale=RU"
```

```

--------------------------------

### GET /me

Source: https://api.hh.ru/openapi/specification/public

API endpoint for GET /me

```markdown
### Parameters

- **host** (string (hh.ru|rabota.by|hh1.az|hh.uz|hh.kz|headhunter.ge|headhunter.kg), query, optional): Доменное имя сайта (см. [Выбор сайта](#section/Obshaya-informaciya/Vybor-sajta))

- **locale** (string, query, optional): Идентификатор локали (см. [Локализация](#tag/Obshie-spravochniki/operation/get-locales))

- **HH-User-Agent** (string, header, required): Название приложения и контактная почта разработчика (см. [Информация о клиенте](#section/Obshaya-informaciya/Trebovaniya-k-zaprosam))


### Responses

#### 200 - Успешный ответ

**MeProfile**
- **auth_type** (string) (required): Тип авторизации (example: "applicant")
- **is_admin** (boolean) (required): Является ли текущий пользователь администратором сайта (example: false)
- **is_applicant** (boolean) (required): Является ли текущий пользователь соискателем (example: false)
- **is_application** (boolean) (required): Является ли авторизованный клиент приложением (example: false)
- **is_employer** (boolean) (required): Является ли текущий пользователь менеджером (example: false)
- **is_employer_integration** (boolean) (required): Является ли текущий пользователь работодателем (example: false)

#### 403 - Ошибка авторизации

**ErrorsCommonBadAuthorizationErrors**
- **request_id** (string) (required): Идентификатор запроса (example: "q1ww2e2r4ty")
- **description** (string): Описание ошибки (example: "Forbidden")
- **errors** (array (ErrorsCommonBadAuthorizationCommonAndEmployerError)) (required): Массив с данными ошибок
  Array items:
    - **type** (string (forbidden|oauth)) (required): Текстовый идентификатор типа ошибки (example: "oauth") ("forbidden"|"oauth")
    - **value** (string (bad_authorization|token_expired|token_revoked|application_not_found|user_auth_expected|application_auth_expected|no_scope|used_manager_account_forbidden|manager_extra_account_not_found)): Общие ошибки:
  * `bad_authorization` — Токен авторизации не существует или не валидный
  * `token_expired` — Время жизни access_token завершилось, необходимо [выполнить обновление access_token](#section/Avtorizaciya/Obnovlenie-pary-access-i-refresh-tokenov)
  * `token_revoked` — Токен отозван пользователем или сервером, приложению необходимо [запросить новую авторизацию](#section/Tipy-avtorizacij)
  * `application_not_found` — Ваше приложение было удалено
  * `user_auth_expected` — Передана авторизация приложения, метод требует [авторизации пользователя](#section/Avtorizaciya/Avtorizaciya-polzovatelya)
  * `application_auth_expected` — Передана авторизация пользователя, метод требует [авторизации приложения](#tag/Avtorizaciya-prilozheniya)
  * `no_scope` - В токене отсутствует необходимый скоуп
  * `used_manager_account_forbidden` — [Рабочий аккаунт](#tag/Menedzhery-rabotodatelya/operation/get-manager-accounts) заблокирован
  * `manager_extra_account_not_found` — В заголовке передан некорректный id аккаунта
 (example: "bad_authorization") ("bad_authorization"|"token_expired"|"token_revoked"|"application_not_found"|"user_auth_expected"|"application_auth_expected"|"no_scope"|"used_manager_account_forbidden"|"manager_extra_account_not_found")
- **oauth_error** (string (token-revoked|token-expired|bad-auth-type|client-id-deleted)): Ошибки авторизации:
  * `token-revoked` — Токен отозван пользователем или сервером, приложению необходимо [запросить новую авторизацию](#tag/Avtorizaciya-rabotodatelya/operation/authorize)
  * `token-expired` — Время жизни `access_token` завершилось, необходимо [получить `refresh_token`](#tag/Avtorizaciya-rabotodatelya/operation/authorize)
  * `bad-auth-type` — Некорректный токен
  * `client-id-deleted` — Приложение удалено. Токен не действителен
 (example: "token-revoked") ("token-revoked"|"token-expired"|"bad-auth-type"|"client-id-deleted")

### Example Usage

```bash
curl -X GET "https://api.hh.ru/me?host=hh.ru&locale=RU"
```

```

--------------------------------

### POST /common/chats/files/upload_links

Source: https://api.hh.ru/openapi/specification/public

Получить ссылку для отправки файла в чат

По полученной ссылке необходимо отправить POST-запрос с файлом и заголовком авторизации аналогичному запросам в api.
Файл нужно отправлять в теле с типом `form-data` и именем ключа `file`

Пример curl запроса:
```
curl --location 'https://example.com' \
--header 'Authorization: Bearer AUTHTOKEN' \
--form 'file=@"/path/to/file"'
```
В ответ вам вернется код успешного ответа с upload_id
```
200:
{
  upload_id: "8abcdef8-4abc-4edf-1234-1234567890ab",
  ...
}
```
Возможные ошибки при отправке файлов по ссылке

При отсутствии авторизации:
```
403: 
<html><title>403: Forbidden</title><body>403: Forbidden</body></html>
```
При несоответствии формата файла
```
400: 
{
  "errors": [
      {
          "type": "bad_argument",
          "value": "file"
      }
  ]
}
```
При истечении срока существования ссылки
```
400:
    {
  "errors": [
      {
          "type": "bad_argument",
          "value": "state"
      }
  ]
}
```


```markdown
### Parameters

- **host** (string (hh.ru|rabota.by|hh1.az|hh.uz|hh.kz|headhunter.ge|headhunter.kg), query, optional): Доменное имя сайта (см. [Выбор сайта](#section/Obshaya-informaciya/Vybor-sajta))

- **locale** (string, query, optional): Идентификатор локали (см. [Локализация](#tag/Obshie-spravochniki/operation/get-locales))

- **HH-User-Agent** (string, header, required): Название приложения и контактная почта разработчика (см. [Информация о клиенте](#section/Obshaya-informaciya/Trebovaniya-k-zaprosam))


### Responses

#### 200 - Ссылка для загрузки файла

**ChatsCommonFilesUploadLinksResponse**
- **expires_at** (string) (required): Время действия ссылки в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) с точностью до секунды: `YYYY-MM-DDThh:mm:ss±hhmm`
- **upload_url** (string) (required): Ссылка для отправки файла POST запросом

#### 403 - response

**ErrorsCommonBadAuthorizationErrors**
- **request_id** (string) (required): Идентификатор запроса (example: "q1ww2e2r4ty")
- **description** (string): Описание ошибки (example: "Forbidden")
- **errors** (array (ErrorsCommonBadAuthorizationCommonAndEmployerError)) (required): Массив с данными ошибок
  Array items:
    - **type** (string (forbidden|oauth)) (required): Текстовый идентификатор типа ошибки (example: "oauth") ("forbidden"|"oauth")
    - **value** (string (bad_authorization|token_expired|token_revoked|application_not_found|user_auth_expected|application_auth_expected|no_scope|used_manager_account_forbidden|manager_extra_account_not_found)): Общие ошибки:
  * `bad_authorization` — Токен авторизации не существует или не валидный
  * `token_expired` — Время жизни access_token завершилось, необходимо [выполнить обновление access_token](#section/Avtorizaciya/Obnovlenie-pary-access-i-refresh-tokenov)
  * `token_revoked` — Токен отозван пользователем или сервером, приложению необходимо [запросить новую авторизацию](#section/Tipy-avtorizacij)
  * `application_not_found` — Ваше приложение было удалено
  * `user_auth_expected` — Передана авторизация приложения, метод требует [авторизации пользователя](#section/Avtorizaciya/Avtorizaciya-polzovatelya)
  * `application_auth_expected` — Передана авторизация пользователя, метод требует [авторизации приложения](#tag/Avtorizaciya-prilozheniya)
  * `no_scope` - В токене отсутствует необходимый скоуп
  * `used_manager_account_forbidden` — [Рабочий аккаунт](#tag/Menedzhery-rabotodatelya/operation/get-manager-accounts) заблокирован
  * `manager_extra_account_not_found` — В заголовке передан некорректный id аккаунта
 (example: "bad_authorization") ("bad_authorization"|"token_expired"|"token_revoked"|"application_not_found"|"user_auth_expected"|"application_auth_expected"|"no_scope"|"used_manager_account_forbidden"|"manager_extra_account_not_found")
- **oauth_error** (string (token-revoked|token-expired|bad-auth-type|client-id-deleted)): Ошибки авторизации:
  * `token-revoked` — Токен отозван пользователем или сервером, приложению необходимо [запросить новую авторизацию](#tag/Avtorizaciya-rabotodatelya/operation/authorize)
  * `token-expired` — Время жизни `access_token` завершилось, необходимо [получить `refresh_token`](#tag/Avtorizaciya-rabotodatelya/operation/authorize)
  * `bad-auth-type` — Некорректный токен
  * `client-id-deleted` — Приложение удалено. Токен не действителен
 (example: "token-revoked") ("token-revoked"|"token-expired"|"bad-auth-type"|"client-id-deleted")

### Example Usage

```bash
curl -X POST "https://api.hh.ru/common/chats/files/upload_links?host=hh.ru&locale=RU"
```

```

--------------------------------

### GET /common/chats/counters/unread

Source: https://api.hh.ru/openapi/specification/public

API endpoint for GET /common/chats/counters/unread

```markdown
### Parameters

- **host** (string (hh.ru|rabota.by|hh1.az|hh.uz|hh.kz|headhunter.ge|headhunter.kg), query, optional): Доменное имя сайта (см. [Выбор сайта](#section/Obshaya-informaciya/Vybor-sajta))

- **locale** (string, query, optional): Идентификатор локали (см. [Локализация](#tag/Obshie-spravochniki/operation/get-locales))

- **HH-User-Agent** (string, header, required): Название приложения и контактная почта разработчика (см. [Информация о клиенте](#section/Obshaya-informaciya/Trebovaniya-k-zaprosam))


### Responses

#### 200 - Успешный ответ с данными о количестве непрочитанных чатов

**ChatsCommonUnreadChatsCountResponse**
- **unread_chats_count** (string) (required): Количестве непрочитанных чатов

#### 403 - response

**ErrorsCommonBadAuthorizationErrors**
- **request_id** (string) (required): Идентификатор запроса (example: "q1ww2e2r4ty")
- **description** (string): Описание ошибки (example: "Forbidden")
- **errors** (array (ErrorsCommonBadAuthorizationCommonAndEmployerError)) (required): Массив с данными ошибок
  Array items:
    - **type** (string (forbidden|oauth)) (required): Текстовый идентификатор типа ошибки (example: "oauth") ("forbidden"|"oauth")
    - **value** (string (bad_authorization|token_expired|token_revoked|application_not_found|user_auth_expected|application_auth_expected|no_scope|used_manager_account_forbidden|manager_extra_account_not_found)): Общие ошибки:
  * `bad_authorization` — Токен авторизации не существует или не валидный
  * `token_expired` — Время жизни access_token завершилось, необходимо [выполнить обновление access_token](#section/Avtorizaciya/Obnovlenie-pary-access-i-refresh-tokenov)
  * `token_revoked` — Токен отозван пользователем или сервером, приложению необходимо [запросить новую авторизацию](#section/Tipy-avtorizacij)
  * `application_not_found` — Ваше приложение было удалено
  * `user_auth_expected` — Передана авторизация приложения, метод требует [авторизации пользователя](#section/Avtorizaciya/Avtorizaciya-polzovatelya)
  * `application_auth_expected` — Передана авторизация пользователя, метод требует [авторизации приложения](#tag/Avtorizaciya-prilozheniya)
  * `no_scope` - В токене отсутствует необходимый скоуп
  * `used_manager_account_forbidden` — [Рабочий аккаунт](#tag/Menedzhery-rabotodatelya/operation/get-manager-accounts) заблокирован
  * `manager_extra_account_not_found` — В заголовке передан некорректный id аккаунта
 (example: "bad_authorization") ("bad_authorization"|"token_expired"|"token_revoked"|"application_not_found"|"user_auth_expected"|"application_auth_expected"|"no_scope"|"used_manager_account_forbidden"|"manager_extra_account_not_found")
- **oauth_error** (string (token-revoked|token-expired|bad-auth-type|client-id-deleted)): Ошибки авторизации:
  * `token-revoked` — Токен отозван пользователем или сервером, приложению необходимо [запросить новую авторизацию](#tag/Avtorizaciya-rabotodatelya/operation/authorize)
  * `token-expired` — Время жизни `access_token` завершилось, необходимо [получить `refresh_token`](#tag/Avtorizaciya-rabotodatelya/operation/authorize)
  * `bad-auth-type` — Некорректный токен
  * `client-id-deleted` — Приложение удалено. Токен не действителен
 (example: "token-revoked") ("token-revoked"|"token-expired"|"bad-auth-type"|"client-id-deleted")

### Example Usage

```bash
curl -X GET "https://api.hh.ru/common/chats/counters/unread?host=hh.ru&locale=RU"
```

```

--------------------------------

### GET /vacancy_conditions

Source: https://api.hh.ru/openapi/specification/public

API endpoint for GET /vacancy_conditions

```markdown
### Parameters

- **host** (string (hh.ru|rabota.by|hh1.az|hh.uz|hh.kz|headhunter.ge|headhunter.kg), query, optional): Доменное имя сайта (см. [Выбор сайта](#section/Obshaya-informaciya/Vybor-sajta))

- **locale** (string, query, optional): Идентификатор локали (см. [Локализация](#tag/Obshie-spravochniki/operation/get-locales))

- **HH-User-Agent** (string, header, required): Название приложения и контактная почта разработчика (см. [Информация о клиенте](#section/Obshaya-informaciya/Trebovaniya-k-zaprosam))


### Responses

#### 200 - Успешный ответ

**VacanciesVacancyConditions**
- **accept_handicapped** (string ()): Объект, значение которого null ("null")
- **accept_incomplete_resumes** (string ()): Объект, значение которого null ("null")
- **accept_kids** (string ()): Объект, значение которого null ("null")
- **accept_labor_contract** (string ()): Объект, значение которого null ("null")
- **accept_temporary** (string ()): Объект, значение которого null ("null")
- **address** (string ()): Объект, значение которого null ("null")
- **age_restriction** (string ()): Объект, значение которого null ("null")
- **allow_messages** (string ()): Объект, значение которого null ("null")
- **area** (string ()): Объект, значение которого null ("null")
- **auto_response** (string ()): Объект, значение которого null ("null")
- **billing_type** (string ()): Объект, значение которого null ("null")
- **branded_template** (string ()): Объект, значение которого null ("null")
- **civil_law_contracts** (string ()): Объект, значение которого null ("null")
- **closed_for_applicants** (string ()): Объект, значение которого null ("null")
- **code** (string ()): Объект, значение которого null ("null")
- **contacts** (string ()): Объект, значение которого null ("null")
- **custom_employer_name** (string ()): Объект, значение которого null ("null")
- **department** (string ()): Объект, значение которого null ("null")
- **description** (string ()): Объект, значение которого null ("null")
- **driver_license_types** (string ()): Объект, значение которого null ("null")
- **employment** (string ()): Объект, значение которого null ("null")
- **employment_form** (string ()): Объект, значение которого null ("null")
- **experience** (string ()): Объект, значение которого null ("null")
- **fly_in_fly_out_duration** (string ()): Объект, значение которого null ("null")
- **key_skills** (string ()): Объект, значение которого null ("null")
- **languages** (string ()): Объект, значение которого null ("null")
- **manager** (string ()): Объект, значение которого null ("null")
- **name** (string ()): Объект, значение которого null ("null")
- **professional_roles** (string ()): Объект, значение которого null ("null")
- **response_letter_required** (string ()): Объект, значение которого null ("null")
- **response_notifications** (string ()): Объект, значение которого null ("null")
- **response_url** (string ()): Объект, значение которого null ("null")
- **salary** (string ()): Объект, значение которого null ("null")
- **salary_range** (string ()): Объект, значение которого null ("null")
- **schedule** (string ()): Объект, значение которого null ("null")
- **test** (string ()): Объект, значение которого null ("null")
- **type** (string ()): Объект, значение которого null ("null")
- **vacancy_properties** (string ()): Объект, значение которого null ("null")
- **work_format** (string ()): Объект, значение которого null ("null")
- **work_schedule_by_days** (string ()): Объект, значение которого null ("null")
- **working_days** (string ()): Объект, значение которого null ("null")
- **working_hours** (string ()): Объект, значение которого null ("null")
- **working_time_intervals** (string ()): Объект, значение которого null ("null")
- **working_time_modes** (string ()): Объект, значение которого null ("null")

#### 403 - Условия заполнения полей вакансии недоступны данному пользователю

**ErrorsCommonBadAuthorizationErrors**
- **request_id** (string) (required): Идентификатор запроса (example: "q1ww2e2r4ty")
- **description** (string): Описание ошибки (example: "Forbidden")
- **errors** (array (ErrorsCommonBadAuthorizationCommonAndEmployerError)) (required): Массив с данными ошибок
  Array items:
    - **type** (string (forbidden|oauth)) (required): Текстовый идентификатор типа ошибки (example: "oauth") ("forbidden"|"oauth")
    - **value** (string (bad_authorization|token_expired|token_revoked|application_not_found|user_auth_expected|application_auth_expected|no_scope|used_manager_account_forbidden|manager_extra_account_not_found)): Общие ошибки:
  * `bad_authorization` — Токен авторизации не существует или не валидный
  * `token_expired` — Время жизни access_token завершилось, необходимо [выполнить обновление access_token](#section/Avtorizaciya/Obnovlenie-pary-access-i-refresh-tokenov)
  * `token_revoked` — Токен отозван пользователем или сервером, приложению необходимо [запросить новую авторизацию](#section/Tipy-avtorizacij)
  * `application_not_found` — Ваше приложение было удалено
  * `user_auth_expected` — Передана авторизация приложения, метод требует [авторизации пользователя](#section/Avtorizaciya/Avtorizaciya-polzovatelya)
  * `application_auth_expected` — Передана авторизация пользователя, метод требует [авторизации приложения](#tag/Avtorizaciya-prilozheniya)
  * `no_scope` - В токене отсутствует необходимый скоуп
  * `used_manager_account_forbidden` — [Рабочий аккаунт](#tag/Menedzhery-rabotodatelya/operation/get-manager-accounts) заблокирован
  * `manager_extra_account_not_found` — В заголовке передан некорректный id аккаунта
 (example: "bad_authorization") ("bad_authorization"|"token_expired"|"token_revoked"|"application_not_found"|"user_auth_expected"|"application_auth_expected"|"no_scope"|"used_manager_account_forbidden"|"manager_extra_account_not_found")
- **oauth_error** (string (token-revoked|token-expired|bad-auth-type|client-id-deleted)): Ошибки авторизации:
  * `token-revoked` — Токен отозван пользователем или сервером, приложению необходимо [запросить новую авторизацию](#tag/Avtorizaciya-rabotodatelya/operation/authorize)
  * `token-expired` — Время жизни `access_token` завершилось, необходимо [получить `refresh_token`](#tag/Avtorizaciya-rabotodatelya/operation/authorize)
  * `bad-auth-type` — Некорректный токен
  * `client-id-deleted` — Приложение удалено. Токен не действителен
 (example: "token-revoked") ("token-revoked"|"token-expired"|"bad-auth-type"|"client-id-deleted")

### Example Usage

```bash
curl -X GET "https://api.hh.ru/vacancy_conditions?host=hh.ru&locale=RU"
```

```

--------------------------------

### Schema: Опыт работы в организации

Source: https://api.hh.ru/openapi/specification/public

Schema definition for ResumeObjectsExperienceShort

```markdown
## Schema: Опыт работы в организации

Schema definition for ResumeObjectsExperienceShort

**Type:** object

- **area** (object)
  - **id** (string) (required): Идентификатор
  - **name** (string) (required): Название
  - **url** (string) (required): URL получения информации о поле
- **company** (string): Название организации
- **company_id** (string): Уникальный идентификатор организации
- **company_url** (string): Сайт компании
- **employer** (object)
  - **alternate_url** (string) (required): Ссылка на описание работодателя на сайте
  - **id** (string) (required): Идентификатор работодателя
  - **logo_urls** (object)
    - **90** (string): URL логотипа с размером менее 90px по меньшей стороне
    - **240** (string): URL логотипа с размером менее 240px по меньшей стороне
    - **original** (string) (required): URL необработанного логотипа
  - **name** (string) (required): Название работодателя
  - **url** (string) (required): URL для получения полного описания работодателя
- **end** (string): Окончание работы (дата в формате `ГГГГ-ММ-ДД`)
- **id** (string): Идентификатор
- **industries** (array (_IncludesIdName)): Список отраслей компании. Возможные значения приведены в [справочнике индустрий](#tag/Obshie-spravochniki/operation/get-industries)
  Array items:
- **industry** (object)
  - **id** (string) (required): Идентификатор поля
  - **name** (string) (required): Название поля
- **position** (string): Должность
- **start** (string): Начало работы (дата в формате `ГГГГ-ММ-ДД`)

```

--------------------------------

### GET /locales

Source: https://api.hh.ru/openapi/specification/public

Возвращает список возможных значений (доступных локалей) в поле `id`. Список локалей будет зависеть от указанного сайта (параметр `host`). В любом запросе к API можно указывать параметр `?locale=` для передачи значения локали (языка)


```markdown
### Parameters

- **host** (string (hh.ru|rabota.by|hh1.az|hh.uz|hh.kz|headhunter.ge|headhunter.kg), query, optional): Доменное имя сайта (см. [Выбор сайта](#section/Obshaya-informaciya/Vybor-sajta))

- **locale** (string, query, optional): Идентификатор локали (см. [Локализация](#tag/Obshie-spravochniki/operation/get-locales))

- **HH-User-Agent** (string, header, required): Название приложения и контактная почта разработчика (см. [Информация о клиенте](#section/Obshaya-informaciya/Trebovaniya-k-zaprosam))


### Responses

#### 200 - Успешный ответ

**LocalesLocales**
- Array of LocalesLocaleItem

### Example Usage

```bash
curl -X GET "https://api.hh.ru/locales?host=hh.ru&locale=RU"
```

```