Каталог ошибок¶

Все ответы с ошибками: причина и что делать.

Как читать ошибку¶

Ответ	Формат
Результат операции	HTTP 200, `{"successful": false, "message": "..."}`
Ошибка доступа, ошибка формата	HTTP 401 или 400, `{"message": "...", "code": 401, "result": "error"}`

Если message заканчивается словом code и числом, ориентируйтесь на число. Остальной текст не анализируйте: он может измениться.

{"successful": false, "message": "Exception while trying to buy object, code 2023"}

Код	Причина	Что делать
2006	ID услуги — не подписка, например это тариф на отдельное видео	Используйте ID услуги подписки от менеджера MEGOGO
2009	Подписка не продается	Обратитесь к своему менеджеру MEGOGO
2010	Подписка не найдена	Обратитесь к своему менеджеру MEGOGO
2012	Неправильные настройки подписки или тарифа	Обратитесь к своему менеджеру MEGOGO
2013	Подписка недоступна в регионе	Обратитесь к своему менеджеру MEGOGO
2016	MEGOGO не может создать услугу пользователя	Повторите позже. Если ошибка не исчезает, напишите в поддержку MEGOGO
2023	Подписка уже активна, а услуга с автоматическим продлением (`subscribe`, `resume`). Или дата окончания вышла бы дальше чем 15 лет от текущего момента	Ничего делать не нужно
40009	Подписка не продается через партнеров	Обратитесь к своему менеджеру MEGOGO

`message`	Запрос	Причина	Что делать
`User doesn't not exist`	`user/phone`	Номер телефона не зарегистрирован в MEGOGO. Текст приведен так, как его возвращает API	Ничего делать не нужно. `subscribe` создаст пользователя
`Invalid phone number format`	`user/phone`	В номере телефона есть не только цифры	Отправляйте только цифры, в начале допускается `+`
`General error`	`subscriptions`, `subscription/{operation}`	В номере телефона есть не только цифры, или другая ошибка	Проверьте номер. Если ошибка не исчезает, напишите в поддержку MEGOGO
`Service is not configured for this partner`	`subscription/{operation}`	ID услуги не настроен для вашего ID партнера	Используйте ID услуги от менеджера MEGOGO
`Invalid operation passed`	`subscription/{operation}`	Операция не `subscribe`, `unsubscribe`, `suspend` или `resume`	Исправьте URL

HTTP-статус	Тело	Причина	Что делать
400	`{"message": "Invalid request format", "code": 400, "result": "error"}`	Обязательного параметра нет в запросе, или он пустой	Добавьте параметр
401	`{"message": "Not Authorized", "code": 401, "result": "error"}`	Подпись неправильная или отсутствует. Или ID партнера или публичный ключ неизвестны. Или IP-адреса нет в списке вашего ID партнера	См. Решение проблем
429	—	Больше 1000 запросов в минуту для вашего ID партнера	Уменьшите количество запросов
5xx, таймаут	—	Временная проблема	См. Повторные запросы

Ответ	Что означает
`unsubscribe` или `suspend`: `"successful": true`	Так будет и тогда, когда подписка не активна. Состояние проверяйте через `subscriptions`
`resume`: `"successful": true` без приостановленной подписки	`resume` сработал как `subscribe`: добавил период или подключил подписку
`subscriptions` с номером телефона: `[]`	У пользователя нет активных услуг. Если номер не был зарегистрирован, запрос создал пользователя