https://api.vkplay.ru/account/
https://account.vkplay.ru/api/
https://api.my.games/account/
https://account.my.games/api/
query_string
application/json
application/json
Логин и секрет передаются с помощью Basic HTTP Authorization, в заголовке Authorization
Authorization: Basic base64('login:secret')
В качестве login/secret используется sezam_id проекта и его секрет
Так же нужно передавать user_id.
Авторизацонные куки My.Games
Передавать как параметр mailer_jwt. JWT получается из письма пользователя.
Кастомное письмо подтверждения выбирается в настройках проекта. Поле: "Письмо double opt-in"
Получение списка подписок аккаунта по всем проектам
Изменение подписок аккаунта
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| profile_categories | int | Да | Список категорий |
| client_id | string | Нет | Sezam_id проекта, не нужен при сервер-сервер авторизации |
| user_id | int | Нет | user_id используется при сервер-сервер авторизации |
Получение статуса подписки пользователя в проекте
| Параметр | Описание |
|---|---|
| Email пользователя в MY.GAMES | |
| email_verified | Стутус верефикации емейл |
| subscribed_categories | Категории подписок пользователя, отсутсвие категорий равнозначно отписке |
| subscribed_at | Дата подписки. Ставится единожды, при первой подписке |
| spam_reported_at | Дата добавления в спам карантин. Если не пусто - письма отправляться не будут |
| bounce_at | Дата получения hard bounce. Если не пусто - письма отправляться не будут |
| unsubscribed_at | Дата отписки. Если не пусто - письма отправляться не будут. Очищается при проставлении любой категории (подписке) |
| can_change_email | Флаг возможности смены емейла через api |
| can_change_email_in_account | Флаг возможности смены емейла через настройки аккаунта |
Подписка
В случае проставления или не верефицированного емейла отправит письмо подтверждения. Письмо отправляется не чаще одного раза в пять минут.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| client_id | string | Нет | Sezam_id проекта, не нужен при сервер-сервер авторизации |
| user_id | int | Нет | user_id используется при сервер-сервер авторизации |
| Нет | используется если не выставлен alt_email в аккаунте или для смены | ||
| lang | string | Нет | Язык |
| continue_url | string | Нет | Url редиректа из письма, также будет передан mailer_jwt |
| category | int | Нет | Категории подписки. При отсутствии, пользователь будет подписан на все категории сразу. |
| not_verify | any | Нет | При передаче значения письмо верификации альт емейла отправляться не будет. |
| Параметр | Описание |
|---|---|
| status | Статус (ok, fail) |
| detail | Пояснение |
| email_send | Флаг отправки письма, для верификации/смены email |
| code | Код ошибки, если есть |
Изменение alt_email аккаунта
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| да | емейл который будет выставлен в alt_email в аккаунте | ||
| client_id | string | Нет | Sezam_id проекта, не нужен при сервер-сервер авторизации |
| user_id | int | Нет | user_id используется при сервер-сервер авторизации |
| continue_url | string | Нет | Url редиректа из письма, также будет передан mailer_jwt |
Повторная отправка верификации alt_email
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| client_id | string | Нет | Sezam_id проекта, не нужен при сервер-сервер авторизации |
| user_id | int | Нет | user_id используется при сервер-сервер авторизации |
| continue_url | string | Нет | Url редиректа из письма, также будет передан mailer_jwt |
| Код | Описание |
|---|---|
| 7000 | Внутренняя ошибка. Пожалуйста попробуйте позже |
| 7101 | Вы не подписаны ни на один проект |
| 7102 | Проект не найден |
| 7103 | Не удалось обновить подписки |
| 7104 | Не удалось отправить верификационное письмо. Попробуйте позже. |
| 7105 | Не удалось обновить email |
| 7106 | Нельзя поменять email для данного аккаунта |
| 7107 | Для смены емейла воспользуйтесь настройками аккаунта |
| 7108 | Новый емейл не передан |
| 7109 | Не удалось отправить верификационное письмо. Попробуйте позже. |
| 7110 | Не удалось обновить email |
| 7111 | Не удалось отправить верификационное письмо. Проверьте корректность написания электронного адреса. |
| 7112 | Email адресс должен отличаться |