Changes

Jump to: navigation, search

Application Developers Example

5,336 bytes added, 18:36, 27 May 2014
Новая страница: «==Общая информация== Данный пример пошагово описывает все необходимые шаги для настройки р…»
==Общая информация==
Данный пример пошагово описывает все необходимые шаги для настройки работы стороннего приложения с движком Ace Stream.

Во всех запросах для примера будут использоваться такие переменные:
* ключ продукта <tt>kjYX790gTytRaXV04IvC-xZH3A18sj5b1Tf3I-J5XVS1xsj-j0797KwxxLpBl26HPvWMm</tt>
* API Key: <tt>94d585bda4883a40d969d723adcaba36033e61d8</tt>
* API Secret: <tt>b5dbd62b494664f5bfa9</tt>

==Регистрация разработчика и получение ключа продукта==
Для начала Вам необходимо зарегистрироваться в системе Ace Stream как разработчик приложений, после чего Вы сможете зарегистрировать свое приложение и получить для него ключ продукта. Как это сделать, описано в разделе [[Developers|Разработчики]].

==Работа с движком==
Работать с Вашим приложением будет только движок, для которого активирована опция NoADs.

Если эта опция не активирована, то на любую попытку воспроизвести что-либо движок будет возвращать ошибку с таким текстом:
No ADs option must be activated to use this product

Для начала Вашему приложению необходимо проверить, активирована ли опция NoADs на движке.

Для этого следует использовать метод [[Engine_Service_API#get_services|get_services]] сервисного API движка. Для этого нужно отправить HTTP GET запрос на движок:
<nowiki>http://localhost:6878/webui/api/service?method=get_services&product_key=kjYX790gTytRaXV04IvC</nowiki>

В запросе нужно передать публичную часть ключа продукта (kjYX790gTytRaXV04IvC) в параметре <tt>product_key</tt>.

'''Варианты ответов'''

*если возникла ошибка (нужно выслать нам логи движка)
{"status": "error", "error": "error description"}

*если на движке не активирована опция NoADs
<nowiki>{
“status”: “ok”,
“services”:[]
}</nowiki>

*если на движке активирована опция NoADs
<nowiki>{
“status”: “ok”,
“services”:
[
{
"id": "noAds",
"name": "No ADs",
"valid_from": 1376939146,
"valid_to": 1411671946,
"trial": false,
"description": "\u041e\u0442\u043a\u043b\
u044e\u0447\u0435\u043d\u0438\u0435 \u0440\u0435\u043a\u043b\u0430\u043c\u044b Ace Stream"
}
]
}</nowiki>

Если опция NoADs не активирована, ее нужно активировать. Для этого нужно выполнить такие шаги:
* создать новый ключ пользователя (метод [[Reseller_API#createUserKey|createUserKey]] API для реселлеров)
* активировать опцию NoADs для этого ключа пользователя (метод [[Reseller_API#activateService|activateService]] API для реселлеров)
* загрузить ключ пользователя в движок (метод [[Engine_Service_API#load_extension|extension]] сервисного API движка)

Ниже эти шаги описаны более подробно.

==Создание ключа пользователя==
Запрос:
<nowiki>https://api.acestream.net/reseller?method=createUserKey &crarr;
&api_key=94d585bda4883a40d969d723adcaba36033e61d8 &crarr;
&api_version=1.0 &crarr;
&product=kjYX790gTytRaXV04IvC &crarr;
&sign=fcf118b246892d80111de2661b79edb27ff48f08</nowiki>

Ответ:
<nowiki>{
"userKey":"84acee3a529bafaa65215af6f86d03fe38020b2d",
"extension":"F5T6L+X\/TnhqoXP\/TyzlaaEmAT7uu97HHvJZ8u7 &crarr;
ShbGBf1w4OAgRhP7Hj0+DGzjK2AolsnfkMgOSFq4qYOlgQdWR3nRGJCq &crarr;
bX8QxqRC\/zbNu+3RerhylcdqvVEuAuWSuEQW0\/tgaqKaIVrfVSug\/ &crarr;
SVrBTLtXea\/4FLqXzz8lTYbv90p\/Nmw6jZcpaSaf4ISJQo9d+NTJ15 &crarr;
cz0emN+FtdABjIZNz91NVEWWyzMNl5iorzCWS8lYrdRQgT\/psdbf3N6 &crarr;
T2wfozL2b98yOkGH53eG4uc5wX+75xluvKwnKK32MJ7uDPZpDLHxTNc9 &crarr;
2GCXKEloLFl+IyC91gghJpry6erUN3g9musH9CKvk4TZoZ+RTQINXlxr &crarr;
+IDklEnL6OBnbrMrXSsjxahdQM2yFWRE\/gG91mEB6JNN0z99oswOiMg &crarr;
hx0="
}</nowiki>

==Активация==
Запрос:
<nowiki>https://api.acestream.net/reseller?service=noAds &crarr;
&period=m1 &crarr;
&user_key=84acee3a529bafaa65215af6f86d03fe38020b2d &crarr;
&method=activateService &crarr;
&api_key=94d585bda4883a40d969d723adcaba36033e61d8 &crarr;
&api_version=1.0 &crarr;
&product=kjYX790gTytRaXV04IvC &crarr;
&sign=2f55622fb9c21af5b950c210774ea34247d1a073</nowiki>

Ответ:
<nowiki>{"validFrom":1401204680,"validTo":1403796680}</nowiki>

==Загрузка ключа в движок==
Запрос:
<nowiki></nowiki>

Ответ:
<nowiki></nowiki>

Navigation menu