Решение проблем TikTok Ads
Каталог ошибок
| Код | Категория | Retry | Решение |
|---|---|---|---|
20001 | throttle | Да | Rate limit — ждать x-ratelimit-reset |
20002 | throttle | Да | Дневная квота — снизить объём / ждать сутки |
20003 | throttle | Да | Concurrent limit — снизить параллелизм |
http-429 | throttle | Да | Настоящий HTTP 429 (не body-code) |
tiktok_api_error | payload | Нет | code != 0 в JSON при HTTP 200 — смотрите message |
transport-5xx | transport | Да | Автоповтор |
transport-ECONNABORTED | transport | Да | Автоповтор |
transport-ECONNRESET | transport | Да | Автоповтор |
transport-ETIMEDOUT | transport | Да | Автоповтор |
transport-EAI_AGAIN | transport | Да | DNS — повтор |
TikTok часто отвечает HTTP 200 с ошибкой в теле (code != 0). Throttle коды: 20001, 20002, 20003.
Rate limit
Смотрите x-ratelimit-remaining (countdown) и x-ratelimit-reset (секунды до окна). Backoff: 60s → max 15min.
Авторизация
Refresh token обновляется автоматически. Если access denied к advertiser — роль ≥ Analyst в TikTok Ads Manager.
Данные
Задержка API 1–3 часа за «сегодня». Конверсии требуют Pixel / Events API.