==ТерминыTerms==
* '''Developer''' – Ace Stream user, who is registered as "application developer"
* '''Разработчик''' – пользователь Ace Stream, который зарегистрировался как "рабработчик приложений"
* '''Клиент API client''' - пользовательuser, которыйwho has имеетan доступaccess кto API
* '''User key''' - user ID in Ace Stream system
* '''Ключ пользователя''' - идентификатор пользователя в системе Ace Stream
* '''Option''' - additional service / software service of Ace Stream, which can be activated for a specific user key
* '''Опция''' - дополнительная сервисная/программная услуга Ace Stream, которая может быть активирована для конкретного ключа пользователя
* '''Application''' - developer's application, which works with Ace Stream system
* '''Приложение''' - приложение разработчика, которое работает с системой Ace Stream
==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]], to access which you have to get a [[Product_key/en|product key]]
Предположим, что Вы решили создать приложение, которое работает с системой Ace Stream (например, плеер). Для этого Вам будет необходимо использовать [[Engine_API|API движка Ace Stream]], для доступа к которому необходимо получить [[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.
После этого в меню слева появится раздел "Разработчик", в котором Вы можете посмотреть и изменить настройки API (API Key и API Secret), а также управлять своими приложениями в подразделе "Приложения".
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.
API для разработчиков позволяет разработчикам активировать различные дополнительные опции пользователям своих приложений.
==How to get an access to API==
==Как получить доступ к 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:
Когда пользователь Ace Stream получает статус "разработчик продуктов", он автоматически становится клиентом API и ему предоставляется доступ к API в виде двух идентификаторов:
* '''API key''' - string, used for user's ID in API requests
* '''API key''' - строка, которая используется для идентификации пользователя в запросах API
* '''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 [[Developer_APIReseller_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 [[Developer_APIReseller_API/en#activateService| createUserKey]]. СозданныйUser сkey помощьюcreated этогоusing методаthis ключmethod пользователяhas необходимоto добавитьbe вadded движокto сthe помощьюenging методаusing сервисногоmethod APIof движкаservice engine API [[Engine_Service_API/en#load_extension|load_extension]]
