> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/ru/api-razmesheniya-reklamy/ad-plac-errors.md).

# Ошибки

API размещения рекламы может возвращать следующие коды ответа:

| Код | Описание          | Пояснение                                                                                                                                                                                              |
| --- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 400 | Неверный запрос   | Указывает, что отправленные данные имеют неверный формат.                                                                                                                                              |
| 200 | OK                | Это означает, что запрос либо корректен, либо есть некоторые зоны, которые не удалось найти. Ответ покажет, какие именно это зоны.                                                                     |
| 500 | Внутренняя ошибка | Указывает, что произошла внутренняя ошибка, но причина неизвестна. Свяжитесь с вашим менеджером по работе с аккаунтом или [Отдел по работе с клиентами](https://www.exoclick.com/contact/) за помощью. |

## Сообщения об ошибках 400

| Сообщение                       | Пояснение                                               |
| ------------------------------- | ------------------------------------------------------- |
| Некорректное тело JSON          | Синтаксическая ошибка                                   |
| Неподдерживаемый тип запроса    | Использован неверный HTTP-метод запроса                 |
| Это поле отсутствует            | Отсутствует обязательное поле                           |
| Это поле не ожидалось           | В запрос был добавлен нераспознанный параметр           |
| Это значение должно быть типа X | Для определенного параметра использован неверный формат |

### Пример ошибки 400

Запрос:

```json
{
    "user": {
        "testing": false
    },
    "zones": [
        {
            "id": "12345"
        }
    ]
}
```

Ответ:

```json
{
    "errors": [
        {
            "[user][ua]": "Это поле отсутствует."
        },
        {
            "[user][testing]": "Это поле не ожидалось."
        },
        {
            "[zones][0]": "[id] Это значение должно быть типа int."
        }
    ]
}
```

## Сообщения об ошибках 200

| Сообщение                     | Пояснение                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------ |
| ID зоны не найден             | ID зоны не может быть найден ИЛИ домен конечной точки не соответствует запрошенному рекламному формату |
| Зона или сайт недействительны | Зона или издатель заблокированы.                                                                       |

### Пример ошибки 200

В этом примере мы запросили рекламу для нескольких зон, и некоторые из них вернули ошибки.

Запрос:

```json
{
    "user": {
        "ip": "179.127.135.233",
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:81.0) Gecko/20100101 Firefox/81.0"
    },
    "zones": [
        {
            "id": 1
        },
        {
            "id": 2
        },
        {
            "id": 3
        }   
    ]
}
```

Ответ:

```json
{
    "zones": [
        null,
        {
            "idzone": 2,
            "type": "banner",
            "data": {
                "url": "https://main.example.rocks/click.php?data=H4sIAAAAAAAAA0WPO27DQAxEr.LG7YK__bBMk8ZFzrArrZAiQQLYgFzM4UNZRUCCIMjhw_ACI69SHNYIn4_H7_2qb1d5j9z3Pc1nX.9p.fkGQAAXUvGj4n_D1RNLTaw5iSpgVoQbcbCV2CsytZgyNACBCZASPSUTOAIsSQ1qlFsOVWXeNKDDZ1cuS56j5o1Gtz7K1BonhPHVI09nB_GC1_gMtcwcTl4dHd8dIqdT2k6h4eOG5kK1.7Kts.ncyuijs64unlerZf4BvX2zxCABAAA-",
                "impression": "https://syndication.example.rocks/cimp.php?t=imp&api=1&data=H4sIAAAAAAAAAzVPSW4DMQz7Sj8wBrV5ya1FX9CiD7An9qlFD73MQY+PkmlEG5ZMwqQZjI2wMb0QLpovKk6lJeKSSCyxiL99vLqSz6Nf/9L+++MqrFKeRy3aqrlCQK24oUbfCufmqpmpgpyyiyMgCqsWr8WQtHqBf32+P3aonF2Agw3R320pRJyQyBtc4xJHUJxEvRAtiaijzS6Ud5uj2MLo2keekevuMb57rEdonEj4p54QNaL45UbngHvwKPiDjqqnPPKpwstqmHNera9OZe053DCHrdGXGPUbbttiKlIBAAA=",
                "image": "https://static.example.rocks/library/432437/42ec0144a74a1663f2973ad3070234f8e5633855.jpg"
            }
        },
        null
    ],
    "errors": {
        "0": [
            "Зона 1 не найдена"
        ],
        "2": [
            "Зона 3 не найдена"
        ]
    }
}
```

## zones.data null

Очень редко запрос к рекламной зоне возвращает корректный ответ, но `data` поле будет null. Это означает, что система не нашла объявлений, которые удовлетворяли бы данному запросу с учетом локали пользователя, браузера и т. д.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/api/ru/api-razmesheniya-reklamy/ad-plac-errors.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.