Changes

* '''МаркетПриложение''' - продукт реселлера (как правилосайт, сайтмобильное, либо десктопное приложение) реселлера, через который осуществляется продажа опций

Нужно зайти * войти на страницу сайт https://accounts.acestream.net под своим логином (если у вас нет логина, необходимо [https://accounts.acestream.net/register зарегистрироваться])* выбрать раздел [https://accounts.acestream.net/partnership и "Сотрудничество"] в верхнем меню* нажать кнопку "Стать реселлером"

==Как получить доступ к API для Реселлеровреселлеров==Когда пользователь API для реселлеров позволяет вам активировать различные дополнительные опции пользователям своих приложений. Общая схема работы API для реселлеров выглядит так:* для активации необходимой опции пользователю ваше приложение (сайт, мобильное либо десктопное приложение) отправляет на сервер Ace Stream становится реселлеромзапрос, в котором указывает идентификатор пользователя, он автоматически становится клиентом опцию и период активации* с вашего баланса в системе Ace Stream списывается стоимость указанной опции на указанный период* указанная опция активируется для пользователя, идентификатор которого вы передали в запросе Полное описание API и ему предоставляется доступ к для реселлеров можно найти [[Reseller_API|здесь]]. Для работы с API в виде двух идентификатороввам понадобятся следующие два идентификатора:

Данные идентификаторы можно увидеть в разделе Реселлер -> Настройки API в меню слева. Секретный ключ реселлер может поменять самостоятельно в админ-панели(кнопка "Редактировать настройки API" ).

==Как работает схема для РеселлеровСоздание приложений==Предположим, что Вы решили стать реселлером Ace Stream Для начала работы с API для реселлеров вам необходимо создать как минимум одно приложение. Для этого в разделе Реселлер -> Приложения в меню слева нажимаем кнопку "Создать новое приложение". После это вам будет предложено заполнить поля "Название" (обязательное) и продавать пользователям опцию "No ADsСайт приложения" (отключение рекламы Ace Streamнеобязательное).

Для этого Вам необходимоВсе ваши приложения отображаются в разделе Реселлер -> Приложения в виде таблицы с такими полями:* зарегистрироваться в системе Ace Stream Название - название приложения, которое вы указали при создании* через специальную форму APP_ID - идентификатор приложения (используется в разделе «Партнерка» подать заявку.запросах API)* после подтверждения заявки, создать новый маркет Редактировать - редактировать приложение (партнер может создать несколько маркетов; каждый из которых имеет свое можно изменить название, адрес сайта и идентификатор OAuth2сайт приложения)* провести тестирование работы маркетаOAuth - редактировать настройки OAuth данного приложения* внести деньги на баланс и активировать маркетAPI - открыть API-консоль для данного приложения

Настройки OAuth вам понадобятся только в том случае, если вы планируете идентифицировать пользователей с помощью технологии OAuth2 (как правило, это необходимо для владельцев сайтов). API-консоль позволяет отсылать запросы от имени вашего приложения прямо со страницы сайта. Консоль предназвачена в первую очередь для того, чтобы наглядно показать формирование запросов к API (каждый запрос и ответ появляются в текстовых полях внизу страницы). <span style="color: #a00;">Внимание!</span> API-консоль не является эмулятором запросов - все запросы настоящие и отсылаются на продакшн-сервера. Это значит, что при активации какой-либо платной опции через консоль с вашего баланса будут сняты средства. Если вы хотите поработать с API для реселлеров в тестовой среде, воспользуйтесь [[Reseller_API_Sandbox|песочницей]]. ==Активация опций пользователям==Для того, чтобы продать услугу активировать опцию пользователю, реселлер должен отправить вызвать метод API-запрос [[Reseller_API#activateService|activateService]] с такими данными:

* OAuth2 Client IDAPP_ID (идентификатор приложения)

* идентификатор услугиопции* идентификатор периода, на который необходимо активировать услугуопцию При успешном выполнении запроса с баланса реселлера будет списана определенная сумма, а у пользователя активируется опция на указанный период. Если у пользователя в данный момент уже активирована указанная опция, то срок действия опции продлится на указанный срок. API Key и APP_ID вы можете узнать на сайте в разделе [https://accounts.acestream.net/reseller Реселлер]. Идентификаторы опций и периодов описаны [[Reseller_API|здесь]]

При успешном выполнении запроса с баланса реселлера будет списана определенная суммаКак видно из описания, а у для активации опции реселлер должен знать ключ пользователя активируется услуга на указанный период. Этот ключ можно получить двумя способами: либо по протоколу OAuth2, либо создать новый ключ с помощью API для реселлеров. Первый метод больше подходит для владельцев сайтов. Второй - для разработчиков приложений. Оба метода описаны ниже.

Как видно из описания, ==Схема работы для активации услуги реселлер должен знать владельцев сайтов==Владельцы сайтов могут получить ключ пользователя. Этот ключ реселлер может получить по протоколу с помощью протокола OAuth2.Для этогонеобходимо выполнить следующие шаги:* реселлер на своем сайте размещает кнопку "Войти через Ace Stream", которая выполняет авторизацию пользователя по протоколу OAuth2* после нажатия на эту кнопку все проходит авторизация пользователя согласно OAuth2:

* теперь пользователь авторизирован авторизован на сайте реселлера и у реселлера есть ключ пользователя, по которому он может активировать ему услугуопцию Подробнее ознакомиться с OAuth2 вы можете [[OAuth2|здесь]]. ==Схема работы для разработчиков приложений==Разработчики приложений, как правило, имеют доступ к [[Engine_Service_API|сервисному API движка]]. Это дает им возможность загружать ключи пользователя напрямую в Ace Stream Engine и активировать опции без прямого участия пользователя. Мы предлагаем такую схему работы:* приложение проверяет, активирована ли необходимая опция у пользователя ([[Engine_Service_API#check_user_service|check_user_service]])* если опция не активирована, приложение создает новый ключ пользователя ([[Reseller_API#createUserKey|createUserKey]]) и загружает его в Ace Stream Engine ([[Engine_Service_API#load_extension|load_extension]])* приложение активирует нужную опцию для нового ключа пользователя ([[Reseller_API#activateService|activateService]]) Описанная схема предполагает, что приложение реселлера и Ace Stream Engine запущены на одной и той же машине.