---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/concepts/headers.md
  - https://yandex.com/dev/direct/doc/ru/concepts/headers.md
  - href: ru/concepts/headers.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/dg/concepts/headers.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

# HTTP-заголовки

## Заголовки запроса {#request}

### Authorization

Содержит [OAuth-токен](https://yandex.com/dev/direct/doc/ru/concepts/auth-token.md) пользователя Яндекс Директа, от имени которого осуществляется запрос к API.

   Пример:

   ```text translate=no
   Authorization: Bearer 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f
   ```

### Accept-Language

Язык ответных сообщений. На выбранном языке возвращаются текстовые пояснения к статусам объектов (кампаний, объявлений и др.), тексты ошибок и предупреждений. Поддерживаются следующие языки:

- en — английский;
- ru — русский;
- tr — турецкий;

Пример:

```text translate=no
Accept-Language: ru
```

Если заголовок не указан или содержит язык, не поддерживаемый в API Директа, ответные сообщения формируются на английском языке.

### Client-Login

Логин рекламодателя — клиента рекламного агентства. Обязателен, если запрос осуществляется от имени агентства.

Пример:

```text translate=no
Client-Login: agrom
```

### Use-Operator-Units: true

Расходовать баллы агентства, а не рекламодателя при выполнении запроса. См. раздел [Ограничения, баллы](https://yandex.com/dev/direct/doc/ru/concepts/units.md). Заголовок допустим только в запросах от имени агентства.

### Accept-Encoding: gzip

Получение тела ответа с использованием GZIP сжатия.

### Payment-Token

Финансовый токен. Необходим при вызове финансовых методов.

Пример запроса:

```javascript translate=no
POST /json/v5/ads/ HTTP/1.1
Host: api.direct.yandex.com
Authorization: Bearer 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f
Accept-Language: ru
Client-Login: agrom
Use-Operator-Units: true
Content-Type: application/json; charset=utf-8

{
  "method":"add",
  "params": {
    ...
  }
}
```

## Заголовки ответа {#response}

### RequestId

Уникальный идентификатор запроса (строка), присвоенный сервером API Директа. Возвращается как для успешных, так и для ошибочных запросов.

Пожалуйста, указывайте этот идентификатор при обращении в [службу поддержки](https://yandex.ru/dev/direct/doc/support/troubleshooting/issue.html).

Пример:

```text translate=no
RequestId: 8695244274068608439
```

### Units

Количество баллов: 1. израсходовано при выполнении запроса, 2. доступный остаток суточного лимита, 3. суточный лимит. См. раздел [Ограничения, баллы](https://yandex.com/dev/direct/doc/ru/concepts/units.md).

Пример:

```text translate=no
Units: 10/20828/64000
```

### Units-Used-Login

Логин представителя рекламодателя, если при выполнении запроса израсходованы баллы рекламодателя, или логин представителя агентства, если при выполнении запроса израсходованы баллы агентства.

Пример:

```text translate=no
Units-Used-Login: ttt-agency
```

Пример ответа:

```text translate=no
HTTP/1.1 200 OK
Connection:close
Content-Type:application/json; charset=utf-8
Date:Fri, 28 Nov 2014 17:07:02 GMT
RequestId:8695244274068608439
Units:10/20828/64000
Units-Used-Login:ttt-agency
Server:nginx
Transfer-Encoding:chunked

{
  "result": {
    ...
  }
}
```