==Термины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

==Регистрация и получение ключа продукта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, плеерa player). Для этого Вам будет необходимо использовать To do this you have to use [[Engine_API/en|Engine API движка Ace Stream]], для доступа к которому необходимо получить to access which you have to get a [[Product_key/en|ключ продуктаproduct key]]

Для этого Вам необходимо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), а также управлять своими приложениями в подразделе as well as manage your applications at subsection "ПриложенияApplications", will appear in the menu on the left.

Для того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, как мы проверим Ваше приложение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 APIrequests* '''API secret''' - секретный ключsecret key, который используется для цифровой подписи запросов used for a digital signature of APIrequests

Секретный ключ пользователь может поменять самостоятельно в админ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 [[Developer_APIReseller_API/en#activateService|activateService]] и передать ему такие параметрыand give him the following parameters:

* публичная часть ключа продукта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 [[Developer_APIReseller_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]]