Обработка ошибок

Распространенные ошибки и способы их решения.

402

Недостаточный баланс

Попытка обработки звонков при низком балансе.

json

{
  "error": "Insufficient balance",
  "message": "Queue paused due to low balance",
  "required": 10,
  "available": 5
}

Решение: Пополните баланс через панель. Очереди возобновятся автоматически при балансе > 100 сум.

400

Аудио используется

Попытка удалить аудио, используемое активной очередью.

json

{
  "error": "Cannot delete audio in use",
  "message": "This audio is being used by 2 active queue(s)",
  "queues": [
    {"id":"uuid","name":"Campaign 1","status":"ACTIVE"}
  ]
}

Решение: Сначала приостановите или завершите очереди, затем удалите аудио.

400

Дублирование имени API токена

Создание токена с уже существующим именем.

json

{
  "error": "Token with this name already exists"
}

Решение: Используйте другое имя или отзовите старый токен.

400

Неверный номер телефона

Номер телефона не соответствует требуемому формату.

json

{
  "error": "Invalid phone number format",
  "message": "Phone must start with +998 and have 12 digits"
}

Решение: Формат: +998XXXXXXXXX (например, +998901234567). Всегда указывайте код страны.

200

Очередь уже завершена

Попытка отметить элемент как успешный/неудачный, когда он уже завершён.

json

{
  "success": true,
  "message": "Item already completed",
  "alreadyCompleted": true
}

Примечание: Это идемпотентный ответ (не ошибка). Можно безопасно игнорировать — элемент уже обработан.