Коди помилок
Общие правила взаимодействия с API
- Вы должны стараться минимизировать число лишних запросов к API, особенно это касается методов campaign/info и campaign/stat.
- Не надо постоянно запрашивать ту информацию, которую вы можете хранить на своей стороне.
- Не надо постоянно запрашивать информацию по неактивным РК - в этом просто нет смысла, ответы будут всегда одинаковыми.
- Разумное число запросов к API по 1 РК - 1-2-3, максимум до 10-20 в сутки. Допустимое число запросов для метода campaign/stat не более 1 в час. Таким образом, разумное число запросов на аккаунт (токен) - сотни, максимум до 1000 в сутки. Если вы планируете делать значительно большее число запросов - 99%, что вы используете несовершенный алгоритм, который можно значительно оптимизировать. Если вы твердо уверены, что вам нужно большее число запросов - сначала согласуйте это со службой поддержки.
- Если вы получили ответ с error_code=37 и error=Temporary unavailable, try again later, вы должны повторить аналогичный запрос не ранее чем через 5 минут.
- В случае систематического нарушения указанных правил доступ к API может быть ограничен.
Загальні коди:
1 — параметри запиту відсутні
7 — доступ заборонено
16 — невідома помилка
37 — тимчасово недоступно, спробуйте пізніше
38 — відсутні об’єкти, що відповідають параметрам запиту
41 — досягнуто денний ліміт запитів API детальніше
Додавання РК:
9 — тип кампанії вказано неправильно
10 — некоректний URL
11 — кількість відвідувань менше ніж 1
12 — не заповнено інструкцію для внутрішніх кліків
13 — не вказано ключове слово
14 - не вказано розташування посилання
15 - не заповнено інструкцію для кліка по рекламі
17 - пошукова система не підтримується
36 - багаторядкова інструкція порожня
42 - некоректний json-рядок списку (keywords, links)
Видалення РК:
18 — є виконання, що очікують на підтвердження
19 — не вистачає кредитів на рахунку
40 — є виконання, що очікують на підтвердження, помилка примусової оплати
Додавання виконань РК:
20 — на рахунку недостатньо коштів
Запуск РК:
21 — РК вже запущено
Зупинка РК:
22 — РК вже зупинена
Статистика РК:
23 — неправильно вказано період
24 — не вказано ID сайту та категорії
25 — отримання статистики за деякими ID завершилося з помилкою
Категорії РК:
26 — назва категорії містить менше 2 символів
27 — категорія з такою назвою вже існує
28 — категорію не знайдено
29 — помилка встановлення унікальних IP-адрес у категорії
Зміна РК:
30 — не заповнено інструкцію для кліка
Геодані РК:
31 — не обрано коди країн
Категорія РК:
32 — не можна змінювати категорію