Skip to Content
ПесочницаПодпискиОтказы и лимиты

Отказы и лимиты

Ошибка приходит с StatusName ≠ REQUEST_ACCEPTED, полями ErrorReasonName (машинный код) и ErrorDescription (пояснение). HTTP-код при этом 200 — кроме двух случаев ниже.

Коды ErrorReasonName

КодКогдаЧем воспроизвести
InvalidSubscriberMsisdnНомер не в формате 7XXXXXXXXXXПередать Subscriber_MSISDN из 5 цифр
SubscriberMustBeSpecifiedНет ни номера, ни ClientIP, ни CustomerType=CardCreateSubscription без полей клиента
SubscriptionAlreadyCreatedУ абонента уже есть неотменённая подписка на этом проектеПовторный CreateSubscription с тем же номером
SubscriberNotSupportedОператор абонента не поддерживает тарификациюНомер, оканчивающийся на 0001
SubscriberInBlacklistНомер в чёрном спискеНомер, оканчивающийся на 0002
ClientIPMSISDNCountryNotEqualСтраны по номеру и по IP не совпадаютНомер на 0003 вместе с ClientIP
InvalidClientIPClientIP не разбирается как IP-адрес<ClientIP>not-an-ip</ClientIP>
InvalidPinCodeНеверный PIN, в описании — остаток попытокApproveSubscription с PIN ≠ 1234
ExceededSubscriptionApprovingAttemptsТри неверных PIN подряд либо истекли 3 часа на подтверждениеТри раза подряд неверный PIN
SubscriptionAlreadyApprovedПодписка уже подтвержденаПовторный ApproveSubscription

При SubscriptionAlreadyCreated в ErrorDescription печатается SubscriptionID существующей подписки — чтобы продолжить сценарий, не создавая вторую. Чтобы прогнать сценарий начисто, возьмите другой номер или сначала вызовите CancelSubscription.

HTTP-коды

КодКогда
400Тело не разбирается как XML или пустое — по спеке платформа отвечает 400 Bad request
503Превышен лимит частоты (ниже). В теле — StatusName=SERVICE_UNAVAILABLE
200Все остальные случаи, включая ошибки подписи и параметров

Лимиты частоты

СчётчикПорогиМетоды
ClientIP50 за 10 мин, 200 за 60 минвсе
Subscriber_MSISDN6 за 2 мин, 10 за 20 минCreateSubscription, CancelSubscription
SubscriptionProjectID1000 за 1 мин, 3000 за 5 минвсе

Пороги те же, что в бою. Счётчики независимы: превышение по одному номеру не блокирует остальных абонентов проекта.

Ответ с ошибкой
<Response>
  <StatusName>WRONG_PARAMS</StatusName>
  <ErrorReasonName>SubscriptionAlreadyCreated</ErrorReasonName>
  <ErrorDescription>Subscription already exists: SubscriptionID=10000001, status=Active</ErrorDescription>
</Response>
Отказ по номеру
# номер на 0002 — чёрный список
<Subscriber_MSISDN>79001230002</Subscriber_MSISDN>
 
<Response>
  <StatusName>WRONG_PARAMS</StatusName>
  <ErrorReasonName>SubscriberInBlacklist</ErrorReasonName>
</Response>
Превышен лимит
HTTP/1.1 503 Service Unavailable
 
<Response>
  <StatusName>SERVICE_UNAVAILABLE</StatusName>
  <ErrorDescription>msisdn:79001234567 exceeded 6 requests per 2 min</ErrorDescription>
</Response>
Хуки песочницы: СписанияКоллбеки