Ошибки

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

Код	Описание	Пояснение
400	Неверный запрос	Указывает, что отправленные данные имеют неверный формат.
200	OK	Это означает, что запрос либо корректен, либо есть некоторые зоны, которые не удалось найти. Ответ покажет, какие именно это зоны.
500	Внутренняя ошибка	Указывает, что произошла внутренняя ошибка, но причина неизвестна. Свяжитесь с вашим менеджером по работе с аккаунтом или Отдел по работе с клиентами за помощью.

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

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

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

Запрос:

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

Ответ:

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

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

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

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

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

Запрос:

{
    "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
        }   
    ]
}

Ответ:

{
    "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. Это означает, что система не нашла объявлений, которые удовлетворяли бы данному запросу с учетом локали пользователя, браузера и т. д.