Changes

==ТерминыTerms==* '''РеселлерReseller''' – пользователь Ace Stream, который получил права на продажу платных опций user who has got rights to sell paid Ace Stream options* '''Клиент APIUser key''' - Реселлер, который имеет доступ к API * '''Ключ пользователя''' - идентификатор пользователя 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==Когда пользователь Ace Stream становится реселлером, он автоматически становится клиентом API и ему предоставляется доступ к API в виде двух идентификаторов:* '''API key''' - строка, которая используется для идентификации реселлера в запросах API* '''API secret''' - секретный ключ, который используется для цифровой подписи запросов APIfor resellers allows you to activate different additional options for users of your apps.

==Как работает схема для Реселлеров==Предположим, что Вы решили стать реселлером Ace Stream и продавать пользователям опцию "No ADs" (отключение рекламы Ace Stream)Full description of API for resellers you can find [[Reseller_API|here]].

Для этого Вам необходимоTo work with API you will need the following two identifiers:* зарегистрироваться в системе Ace Stream * через специальную форму в разделе «Партнерка» подать заявку.'''API key''' - string, used for reseller's ID in API requests* после подтверждения заявки, создать новый маркет (партнер может создать несколько маркетов; каждый из которых имеет свое название'''API secret''' - secret key, адрес сайта и идентификатор OAuth2)* провести тестирование работы маркета* внести деньги на баланс и активировать маркетused for a digital signature of API requests

Для того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 API settings"). ==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 API requests)* 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 APIyou 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 OAuth2 protocol, 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 OAuth2 protocol. 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 Stream site** 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 OAuth2 Client IDat 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]])

Как видно из описания, для активации услуги реселлер должен знать ключ пользователя. Этот ключ реселлер может получить по протоколу OAuth2.Для этого:* реселлер на своем сайте размещает кнопку "Войти через Described scheme assumes that reseller's app and Ace Stream", которая выполняет авторизацию пользователя по протоколу OAuth2* после нажатия на эту кнопку все проходит согласно OAuth2:** пользователя перенаправляет на сайт Ace Stream** если он не зарегистрирован, то регистрируется** если зарегистрирован, но не залогинен, то выполняет процедуру входа** если пользователь первый раз входит на сайт реселлера через Ace Stream OAuth2, то он дает свое согласие на предоставление некоторых персональных данных сайту реселлера (email и ключ пользователя)** пользователь возвращается на сайт реселлера** сайт реселлера получает email и ключ пользователя согласно OAuth2* теперь пользователь авторизирован на сайте реселлера и у реселлера есть ключ пользователя, по которому он может активировать ему услугуEngine are run on the same device.