==Общее описание Common description of API==Запросы This API отправляются методом HTTP-GET на такие адреса:* тестовый режим: <tt><nowiki>https://api-sandboxallows you to work with user keys in Ace Stream system.acestream.net/reseller</nowiki></tt>* боевой режим: <tt><nowiki>https://api.acestreamAPI provides methods to create user keys and activate different options for the keys.net/reseller</nowiki></tt>

Ответы на запросы приходят в формате json==Requests format==API requests are sent via HTTP-GET method to the following addresses:* test mode: <tt><nowiki>https://api-sandbox.acestream.net/reseller</nowiki></tt>* work mode: <tt><nowiki>https://api.acestream.net/reseller</nowiki></tt>

Если при обработке запроса возникла ошибкаResponses for these requests comes in json format. If during query processing an error was occurred, будет отослан ответ такого видаthe following kind of response will be sent:

===Обязательные общие параметры для всех запросовRequired common parameters for all requests===* '''method''' - вызываемый метод called APImethod* '''api_key''' - ключ клиента APIclient key* '''api_version''' - поддерживаемая версия supported API version (текущая версияcurrent version: 1.0)* '''app''' - идентификатор маркетаmarket ID* '''sign''' - цифровая подпись запросаrequest's digital signature

===Алгоритм формирования цифровой подписиAlgorithm for generating a digital signature===* создается массив строк вида array of strings like "название_параметраparameter_name=значение_параметраparameter_value"is created* полученный массив сортируетсяthe resulting array is sorted* элементы отсортированного массива объединяются в строку с разделителем elements of the sorted array are combined in a string with a separator "#"* к полученной строке добавляется секретный ключ клиента private key of APIclient is added to the resulting string* подписью является signature is sha1-хеш от полученной строки hash of the resulting string (в шестнадцатеричном представленииin hexadecimal representation, 40 символовcharacters, маленькими буквамиlowercase)

Код на PHPcode:

==Методы APImethods==

параметрыparameters:* '''service''' (''string'') - идентификатор опцииservice ID* '''period''' (''string'') - идентификатор периодаperiod ID

поля в ответеfields in response:* '''cost''' (''decimal'') - стоимость опции на указанный период в the cost of the service for a specified period in EUR

пример запросаrequest example:

ответresponse:

параметры:* As a result of successful activation, funds will be charged from reseller'''user_key''' (''string'') - ключ пользователя* '''service''' (''string'') - идентификатор опции* '''period''' (''string'') - идентификатор периодаs balance.

поля в ответеparameters:* '''validFromuser_key''' (''unix timestampstring'') - с какого времени опция активнаuser key* '''validToservice''' (''unix timestampstring'') - до какого времени опция активнаservice ID* '''period''' (''string'') - period ID

пример запросаfields in response:* '''validFrom''' (''unix timestamp'') - from what time service is active* '''validTo''' (''unix timestamp'') - till what time service will be active request example:

ответ response (успешная активация опцииsuccessful activation):

ответ response (на балансе реселлера недостаточно средств для активации опцииthere are not enough funds on resellers balance to activate the service):

параметрыparameters:* '''user_key''' (''string'') - ключ пользователяuser key

поля в ответеfields in response:* '''services''' (''array'') - массив опцийarray of services, привязанных к данному ключу пользователяbound to this user key. Каждая опция описывается такими полямиEach service ia described with the following fields:** '''id''' (''string'') - идентификатор опцииservice ID** '''validFrom''' (''unix timestamp'') - с какого времени опция активнаfrom what time service is active** '''validTo''' (''unix timestamp'') - до какого времени опция активнаtill what time service will be active** '''enabled''' (''boolean'') - активна ли опция в данный моментis service active at this moment

пример запросаrequest example:

ответ response (нет опцийno services):

ответ response (есть опцииthere are services):

Создать новый ключ пользователя параметры:* '''type''' (''integer'') - тип ключа пользователя (1 - ключ, действие которого распостраняется на любые продукты; 2 - ключ, действие которого распостраняется только на указанный продукт)* '''product''' (''integer'') - идентификатор продукта, к которому должен быть привязан ключ пользователя (данный параметр используется только для типа ключа 2)Create a new user key

поля в ответеfields in response:* '''userKey''' (''string'') - созданный ключ пользователяcreated user key* '''extension''' (''string'') - содержимое файла-расширения, который используется для последующей загрузки в движокcontent of extension file which is used for the following loading to the engine

пример запросаrequest example:

ответresponse:

==Идентификаторы опцийService ID==* '''noAds''' - опция service "No ADs" (отключение рекламы disable Ace Streamads)* '''premium''' - опция service "Premium Streams" (доступ к премиумaccess to premium content)* '''premium1device''' - premium for one device* '''proxyServer''' - "Proxy Server" option (it allows using Ace Stream by third-контентуparty software products)

==Идентификаторы периодовPeriod ID==* '''m1''' - 30 днейdays* '''y1''' - 365 днейdays