Ошибки

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

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

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

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

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

Запрос:

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

Ответ:

{
    "errors": [
        {
            "[user][ua]": "This field is missing."
        },
        {
            "[user][testing]": "This field was not expected."
        },
        {
            "[zones][0]": "[id] This value should be of type int."
        }
    ]
}

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

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

пример ошибки 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": [
            "Zone 1 not found"
        ],
        "2": [
            "Zone 3 not found"
        ]
    }
}

zones.data null

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