Changes

==Общее описание Common description of API==Запросы This API отправляются на адрес <tt><nowiki>https://api-devallows you to work with user keys in Ace Stream system.acestream.net</nowiki></tt> методом HTTP-GET.Ответы на запросы приходят в формате jsonAPI 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 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: <nowiki>https://api-dev.acestream.net/reseller?method=getServiceCost &crarr;

ответresponse:

параметры:* As a result of successful activation, funds will be charged from reseller'''app''' (''string'') - ключ приложения* '''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: <nowiki>https://api-dev.acestream.net/reseller?method=activateService &crarr;

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

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

параметрыparameters:* '''app''' (''string'') - ключ приложения* '''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: <nowiki>https://api-dev.acestream.net/reseller?method=getUserKeyInfo &crarr;

ответ response (нет услугno services):

ответ response (есть услугиthere are services):

==Идентификаторы периодов=createUserKey===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:  <nowiki>https://api.acestream.net/reseller?method=createUserKey &crarr; &api_key=cd3119af58cfa8833ba105a4fd4eb791395b921c &crarr; &api_version=1.0 &crarr; &app=3_250o55jdisu88skggogg4g4w4wc8wgskss4gkgkkk40k0gcsw8 &crarr; &sign=99982a11708ef4a80e12f1ca845d314340db8869</nowiki> response: <tt>{ "userKey": "c7456d962209ce22a8edd0c788940a15792bc575", "extension": "F5T6L+X\/TnhqoXP\/Tyzlad51LoGI3InF676iap &crarr; n6vuJUOLbFJNGfYQcakQMXAhSTrlc7XlmUydoGcnCXhw5qefoinHZHIL &crarr; VW51Pd5I0\/0YbKsmn\/Y78F1JhG1ckBExCtQTf\/NgLj+8TeTyPOfQS &crarr; lRub3k4G\/m0+Iqyq4hshKnmTIBlkDcytWZ5DyQFLetllUUz9rLFjvR8 &crarr; mF0qy3GCYtAw==" }</tt> ==Service ID==* '''noAds''' - service "No ADs" (disable Ace Stream ads)* '''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