==ТерминыTerms==* '''РазработчикDeveloper''' – пользователь Ace Streamuser, который зарегистрировался как who is registered as "рабработчик приложенийapplication developer"* '''Клиент APIclient''' - пользовательuser, который имеет доступ к who has an access to API реселлера* '''Ключ пользователяUser key''' - идентификатор пользователя в системе user ID in Ace Streamsystem* '''ОпцияOption''' - дополнительная сервиснаяadditional service /программная услуга software service of Ace Stream, которая может быть активирована для конкретного ключа пользователя which can be activated for a specific user key * '''ПриложениеApplication''' - приложение разработчикаdeveloper's application, которое работает с системой which works with Ace Streamsystem
==Как получить доступ к API для реселлеровRegistration and getting a product key==Когда пользователь Let's suppose that you have decided to create an application, which works with Ace Stream получает статус "разработчик продуктов"system (for example, он автоматически становится клиентом API и ему предоставляется доступ к API в виде двух идентификаторов:* '''a player). To do this you have to use [[Engine_API/en|Engine API ]], to access which you have to get a [[Product_key/en|product key''' - строка, которая используется для идентификации пользователя в запросах API* '''API secret''' - секретный ключ, который используется для цифровой подписи запросов API]]
Секретный ключ пользователь может поменять самостоятельно в админ-панелиTo do this you have to:* register in [https://accounts.acestream.net Ace Stream] system* in section [https://accounts.acestream.net/partnership «Partnership»] press a button "Become a developer"* confirm your agreement with terms and press a button "Register"
==Регистрация и получение ключа продукта==ПредположимAfter this a section "Developer", что Вы решили создать приложениеin which you can view and change API settings (API Key and API Secret), которое работает с системой Ace Stream (напримерas well as manage your applications at subsection "Applications", плеер)will appear in the menu on the left. Для этого Вам будет необходимо использовать [[Engine_API|API движка Ace Stream]], для доступа к которому необходимо получить [[Product_key|ключ продукта]]
Для этого Вам необходимо:* зарегистрироваться в системе [https://accounts.acestream.net Ace Stream]* в разделе [https://accounts.acestream.net/partnership «Партнерка»] нажать кнопку To get the product key for a new application, you have to press a button "Стать разработчикомRegister an application"* подтвердить свое согласие с условиями и нажать кнопку and fill out appeared form. Please, provide as much information about your application in a field "ЗарегистироватьсяDescription", as you can, because it will speed up a procedure for issuing the product key.
После этого в меню слева появится раздел After registering the application you will see it in a list of applications with a status "РазработчикNot confirmed". After we check your application, в котором Вы можете посмотреть и изменить настройки API (API Key и API Secret)you will get a letter with the product key, а также управлять своими приложениями в подразделе the status in the list of applications will be changed to "ПриложенияConfirmed"and public part of the product key will appear. Full product key does not appear in the list of applications for safety reasons.
Для того, чтобы получить ключ продукта для нового приложения, необходимо нажать кнопку "Зарегистрировать приложение" и заполнить появившуюся форму. Просьба предоставлять как можно больше информации о Вашем приложении в поле "Описание", так как это ускорит процедуру выдачи ключа продукта==What is API==API for developers allows them to activate different options for users of their applications.
После регистрации приложения Вы увидите его в списке приложений со статусом ==How to get an access to API==When Ace Stream user receives status "Не подтвержденоproduct developer". После того, как мы проверим Ваше приложениеhe becomes API client automatically and he is provided with the access to API in the form of two identifiers:* '''API key''' - string, Вы получите письмо с ключом продуктаused for user's ID in API requests* '''API secret''' - secret key, в списке приложений статус изменится на "Подтверждено" и появится публичная часть ключа продукта. Полный ключ продукта в списке приложений не выводится из соображений безопасности.used for a digital signature of API requests
You can change reseller's secret key by yourself in admin-panel. ==Активация опций для пользователяActivation of options for user==Для того, чтобы активировать опцию пользователю, необходимо вызвать метод To activate an option for user you have to call API method [[Reseller_API/en#activateService|activateService]] и передать ему такие параметрыand give him the following parameters:
* API key
* публичная часть ключа продуктаpublic part of the product key* ключ пользователяuser key* идентификатор опцииoption ID * идентификатор периодаID of a period, на который необходимо активировать опциюon which you want to activate the option
При успешном выполнении запроса с баланса разработчика будет списана определенная суммаIf the request was completed successfully, а у пользователя активируется опция на указанный периодa certain amount will be charged from developer's balance, and the user will have the option activated for a specified period.
Если у пользователя в данный момент уже активирована указанная опцияIf user has this option activated already, то срок действия опции продлится на указанный срокvalidity of the option will continue for a specified period.
Как видно из описанияAs you can see in the description, для активации опции разработчик должен знать ключ пользователяto activate the option the developer has to know user key. Ключ можно получить с помощью метода This key can be received useing API method [[Reseller_API/en#activateService| createUserKey]]. Созданный с помощью этого метода ключ пользователя необходимо добавить в движок с помощью метода сервисного User key created using this method has to be added to the enging using method of service engine API движка [[Engine_Service_API/en#load_extension|load_extension]]
