Changes

==ТерминыTerms==* '''РеселлерReseller''' – пользователь Ace Stream, который получил права на продажу платных опций user who has got rights to sell paid Ace Stream options* '''Ключ пользователяUser key''' - идентификатор пользователя Ace Streamuser's ID* '''ОпцияOption''' - дополнительная сервиснаяadditional service /программная услуга software service of Ace Stream, которая может быть активирована для конкретного ключа пользователя which can be activated for a specific user key * '''ПриложениеApp''' - продукт реселлера reseller's product (сайт, мобильноеsite, либо десктопное приложениеmobile or desktop application), через который осуществляется продажа опцийwhich is used to sell options

==Как стать реселлеромHow to become a reseller==* войти на сайт log in to site https://accounts.acestream.net под своим логином using your login (если у вас нет логинаif you do not have the login, необходимо you have to [https://accounts.acestream.net/register зарегистрироватьсяregister])* выбрать раздел choose section [https://accounts.acestream.net/partnership "СотрудничествоPartnership"] в верхнем менюin a top menu* нажать кнопку click button "Стать реселлеромBecome a reseller"

==API для реселлеровfor Resellers==API для реселлеров позволяет вам активировать различные дополнительные опции пользователям своих приложенийfor resellers allows you to activate different additional options for users of your apps.

Общая схема работы A common scheme of work of API для реселлеров выглядит такfor resellers looks like this:* для активации необходимой опции пользователю ваше приложение to activate a required option for a user your app (сайтsite, мобильное либо десктопное приложениеmobile or desktop app) отправляет на сервер sends a request to Ace Stream запросserver, в котором указывает идентификатор пользователяin which specifies user's id, опцию и период активацииoption and activation period* с вашего баланса в системе the cost of specified option for the specified period is charged from your balance in Ace Stream списывается стоимость указанной опции на указанный периодsystem* указанная опция активируется для пользователя, идентификатор которого вы передали в запросеspecified option is activated for the user whose id you specified in the request

Полное описание Full description of API для реселлеров можно найти for resellers you can find [[Reseller_API/en|здесьhere]].

Для работы с To work with API вам понадобятся следующие два идентификатораyou will need the following two identifiers:* '''API key''' - строкаstring, которая используется для идентификации реселлера в запросах used for reseller's ID in APIrequests* '''API secret''' - секретный ключsecret key, который используется для цифровой подписи запросов used for a digital signature of APIrequests

Данные идентификаторы можно увидеть в разделе Реселлер You can find these identifiers in section Reseller -> Настройки API в меню слеваsettings in a left menu. Секретный ключ реселлер может поменять самостоятельно The reseller can change a secret key by themselves (кнопка button "Редактировать настройки Edit APIsettings" ).

==Создание приложенийCreating apps==Для начала работы с To start working with API для реселлеров вам необходимо создать как минимум одно приложениеfor resellers you have to create at least one app. Для этого в разделе Реселлер To do this click button "Create a new application" in section Reseller -> Приложения в меню слева нажимаем кнопку "Создать новое приложение"Applications in the left menu. После это вам будет предложено заполнить поля After this you will be proposed to fill fields "НазваниеName" (обязательноеmandatory) и and "Сайт приложенияApplication's site" (необязательноеoptional).

Все ваши приложения отображаются в разделе Реселлер All your apps can be seen in section Reseller -> Приложения в виде таблицы с такими полямиApplications in a table with the following fields:* Название Name - название приложения, которое вы указали при созданииapp's name that you specified when created the app* APP_ID - идентификатор приложения app's identifier (используется в запросах it is used in APIrequests)* Редактировать Edit - редактировать приложение edit the app (можно изменить название и сайт приложенияyou can change app's name and site)* OAuth - редактировать настройки edit settings OAuth данного приложенияof this app* API - открыть open API-консоль для данного приложенияconsole of this app

Настройки You will need OAuth вам понадобятся только в том случае, если вы планируете идентифицировать пользователей с помощью технологии settings only if you plan to identify users using OAuth2 technology (как правилоusually, это необходимо для владельцев сайтовit is necessary for sites' owners).

API-консоль позволяет отсылать запросы от имени вашего приложения прямо со страницы сайтаconsole allows you to send requests on behalf of your application directly from site. Консоль предназначена в первую очередь для того, чтобы наглядно показать формирование запросов к The console is intended primarily to demonstrate the formation of requests to API (каждый запрос и ответ появляются в текстовых полях внизу страницыeach request and response appear in text fields at the bottom of the page).

<span style="color: #a00;">ВниманиеAttention!</span> API-консоль не является эмулятором запросов console is not an emulator of requests - все запросы настоящие и отсылаются на продакшнall requests are real and are sent to production-сервераservers. Это значит, что при активации какой-либо платной опции через консоль с вашего баланса будут сняты средстваIt means that when some paid option is activated from console money will be withdrawn from your balance. Если вы хотите поработать с If you would like to work with API для реселлеров в тестовой средеfor resellers in a test mode, воспользуйтесь use [[Reseller_API_Sandbox|песочницейsandbox]].

==Когда необходимо активировать опцииOptions activation reminder==Движок может сообщать о необходимости активировать ту или иную опцию при старте либо во время воспроизведенияApp engine can notice user about missing options. Метод оповещения зависит от того, какое Notification method depends on API вы используете для управления движкомyou choose:* для пользователей more about Engine API описание [[Engine_API#example-missing-option-on-start|здесьhere]]* для пользователей more about HTTP API описание [[Engine_HTTP_API#stop-notifications|здесьhere]]

==Активация опций пользователямActivation of options for users==Для того, чтобы активировать опцию пользователю, реселлер должен вызвать метод To activate the option for user reseller has to call API method [[Reseller_API#activateService|activateService]] с такими даннымиwith the following data:

* APP_ID (идентификатор приложенияapplication identifier)* ключ пользователяuser key* идентификатор опцииoption ID* идентификатор периода, на который необходимо активировать опциюID of period for which an option has to be activated

При успешном выполнении запроса с баланса реселлера будет списана определенная суммаIf the request was successful a certain amount of money will be charged from reseller's balance, а у пользователя активируется опция на указанный периодand the option for the requested period will be activated.

Если у пользователя в данный момент уже активирована указанная опцияIf a specified option is already activated at this moment, то срок действия опции продлится на указанный срокthen validation period of the option will continue for a stated period.

API Key и and APP_ID вы можете узнать на сайте в разделе you can find out on the site in section [https://accounts.acestream.net/reseller РеселлерReseller].

Идентификаторы опций и периодов описаны Identifiers of options and periods are described [[Reseller_API|здесьhere]]

Как видно из описанияAs it is seen from the description, для активации опции реселлер должен знать ключ пользователяto activate options reseller has to know user key. Этот ключ можно получить двумя способамиThis key can be obtained in two ways: либо по протоколу either via OAuth2protocol, либо создать новый ключ с помощью or to create a new key using API для реселлеровfor resellers. Первый метод больше подходит для владельцев сайтовThe first method is more suitable for sites' owners. Второй The second - для разработчиков приложенийfor apps' developers. Оба метода описаны нижеBoth methods are described below.

==Схема работы для владельцев сайтовWork scheme for sites' owners==Владельцы сайтов могут получить ключ пользователя с помощью протокола Sites' owners can get user key using OAuth2protocol. Для этого необходимо выполнить следующие шагиTo do this they have to do the following steps:* реселлер на своем сайте размещает кнопку reseller places on his site a button "Войти через Log in with Ace Stream"* после нажатия на эту кнопку проходит авторизация пользователя согласно after pressing this button everything goes according to OAuth2:** пользователя перенаправляет на сайт user is redirected to Ace Streamsite** если он не зарегистрированif he's not registered, то регистрируетсяhe registers** если зарегистрированif he's registered, но не залогиненbut not logged in, то выполняет процедуру входаhe logs in** если пользователь первый раз входит на сайт реселлера через if user logs in to reseller's site via Ace Stream OAuth2at the first time, то он дает свое согласие на предоставление некоторых персональных данных сайту реселлера he agrees to provide some of his personal data to reseller's site (email и ключ пользователяand user key)** пользователь возвращается на сайт реселлераuser goes back to reseller's site** сайт реселлера получает reseller's site receives email и ключ пользователя согласно and user key according to OAuth2* теперь пользователь авторизован на сайте реселлера и у реселлера есть ключ пользователяnow user is authorized at reseller's site, по которому он может активировать ему опциюand the reseller has user key, by which he can activate the option for user

Подробнее ознакомиться с More detailed information about OAuth2 вы можете is [[OAuth2/en|здесьhere]].

==Схема работы для разработчиков приложенийWork scheme for apps' developers==Разработчики приложений, как правило, имеют доступ к Apps' developers usually have access to [[Engine_Service_API/en|сервисному Engine service API движка]]. Это дает им возможность загружать ключи пользователя напрямую в It gives them ability to upload user keys directly to Ace Stream Engine и активировать опции без прямого участия пользователяand activate options without direct user intervention.

Мы предлагаем такую схему работыWe propose the following work scheme:* приложение проверяет, активирована ли необходимая опция у пользователя app checks whether the required option is activated ([[Engine_Service_API#check_user_service|check_user_service]])* если опция не активированаif the option is not activated, приложение создает новый ключ пользователя app creates a new user key ([[Reseller_API#createUserKey|createUserKey]]) и загружает его в and uploads it to Ace Stream Engine ([[Engine_Service_API#load_extension|load_extension]])* приложение активирует нужную опцию для нового ключа пользователя app activates a required option for a new user key ([[Reseller_API#activateService|activateService]])

Описанная схема предполагает, что приложение реселлера и Described scheme assumes that reseller's app and Ace Stream Engine запущены на одной и той же машинеare run on the same device.