Resellers

Термины

• Реселлер – пользователь Ace Stream, который получил права на продажу платных опций Ace Stream
• Клиент API - Реселлер, который имеет доступ к API
• Ключ пользователя - идентификатор пользователя Ace Stream
• Опция - дополнительная сервисная/программная услуга Ace Stream, которая может быть активирована для конкретного ключа пользователя
• Маркет - продукт (как правило, сайт) реселлера, через который осуществляется продажа опций

Как получить доступ к API для Реселлеров

Когда пользователь Ace Stream становится реселлером, он автоматически становится клиентом API и ему предоставляется доступ к API в виде двух идентификаторов:

• API key - строка, которая используется для идентификации реселлера в запросах API
• API secret - секретный ключ, который используется для цифровой подписи запросов API

Секретный ключ реселлер может поменять самостоятельно в админ-панели.

Как работает схема для Реселлеров

Предположим, что Вы решили стать реселлером Ace Stream и продавать пользователям опцию "No ADs" (отключение рекламы Ace Stream).

Для этого Вам необходимо:

• зарегистрироваться в системе Ace Stream
• через специальную форму в разделе «Партнерка» подать заявку.
• после подтверждения заявки, создать новый маркет (партнер может создать несколько маркетов; каждый из которых имеет свое название, адрес сайта и идентификатор OAuth2)
• провести тестирование работы маркета
• внести деньги на баланс и активировать маркет

Для того, чтобы продать услугу пользователю, реселлер должен отправить API-запрос с такими данными:

• API key
• OAuth2 Client ID
• ключ пользователя
• идентификатор услуги
• идентификатор периода, на который необходимо активировать услугу

При успешном выполнении запроса с баланса реселлера будет списана определенная сумма, а у пользователя активируется услуга на указанный период.

Как видно из описания, для активации услуги реселлер должен знать ключ пользователя. Этот ключ реселлер может получить по протоколу OAuth2. Для этого:

• реселлер на своем сайте размещает кнопку "Войти через Ace Stream", которая выполняет авторизацию пользователя по протоколу OAuth2
• после нажатия на эту кнопку все проходит согласно OAuth2:
  • пользователя перенаправляет на сайт Ace Stream
  • если он не зарегистрирован, то регистрируется
  • если зарегистрирован, но не залогинен, то выполняет процедуру входа
  • если пользователь первый раз входит на сайт реселлера через Ace Stream OAuth2, то он дает свое согласие на предоставление некоторых персональных данных сайту реселлера (email и ключ пользователя)
  • пользователь возвращается на сайт реселлера
  • сайт реселлера получает email и ключ пользователя согласно OAuth2
• теперь пользователь авторизирован на сайте реселлера и у реселлера есть ключ пользователя, по которому он может активировать ему услугу