Changes

==Общее описание Common description of API==Данное This API позволяет работать с [[User_key|ключами пользователей]] в системе allows you to work with user keys in Ace Streamsystem. API предоставляет методы для создания ключей пользователей и для активации различных опций для ключейprovides methods to create user keys and activate different options for the keys.

==Формат запросов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 jsonformat.

Если при обработке запроса возникла ошибка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's balance.

параметрыparameters:* '''user_key''' (''string'') - ключ пользователяuser key* '''service''' (''string'') - идентификатор опции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):

поля в ответе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