Каталог помилок¶

Усі відповіді з помилками: причина й що робити.

Як читати помилку¶

Відповідь	Формат
Результат операції	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` з номером телефону: `[]`	У користувача немає активних послуг. Якщо номер не був зареєстрований, запит створив користувача