Changes

==Общее описание 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:

Ответы за успешно обработанные запросы зависят от вызываемого метода. ===Обязательные общие параметры для всех запросов===* '''Responses to successfully processed requests depend on a method''' - вызываемый метод API* '''api_key''' - ключ клиента API* '''api_version''' - поддерживаемая версия API (текущая версия: 1.0)* '''sign''' - цифровая подпись запросаbeing called

В зависимости от того, кто обращается к ===Required common parameters for all requests===* '''method''' - called API method* '''api_key''' - API client key* '''api_version''' - supported API version (разработчик или реселлерcurrent version: 1.0), должен присутствовать один из параметров:* '''app''' - идентификатор маркета (для [[Resellers|реселлеров]])market ID* '''productsign''' - публичная часть [[Product_key|ключа продукта]] (для [[Developers|разработчиков приложений]])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:

Активировать опцию для пользователяActivate service for user 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):

Создать новый ключ пользователя параметры:* '''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