117
edits
Changes
no edit summary
==ОбщееCommon описаниеdescription of API==
This API allows you to work with user keys in Ace Stream system. 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 json format.
If during query processing an error was occurred, the following kind of response will be sent:
<tt><nowiki>{"error":"error descrtiption"}</nowiki></tt>
Responses to successfully processed requests depend on a method being called
===Required common parameters for all requests===
* '''method''' - вызываемый методcalled API method
* '''api_key''' - ключAPI клиентаclient APIkey
* '''api_version''' - поддерживаемая версияsupported API version (текущаяcurrent версияversion: 1.0)
* '''app''' - идентификаторmarket приложения (APP_ID)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 API client is added to the resulting string
* signature is sha1-hash of the resulting string (in hexadecimal representation, 40 characters, lowercase)
PHP code:
<tt><nowiki>function makeSignature(array $params, $apiSecret)
{
}</nowiki></tt>
==Методы API methods==
===getServiceCost===
Get the cost of a service
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.acestream.net/reseller?method=getServiceCost ↵
&api_version=1.0 ↵
&sign=45c84ceffd3ec443586e8f4666b28abde8400768</nowiki>
response:
<nowiki>{"cost":1}</nowiki>
===activateService===
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:
<nowiki>https://api.acestream.net/reseller?method=activateService ↵
&api_version=1.0 ↵
&sign=c4df772a4a41ad7bbb4d7d07e46cad5e3622c59e</nowiki>
response (successful activation):
<nowiki>{"validFrom":1376048972,"validTo":1378640972}</nowiki>
response (there are not enough funds on resellers balance to activate the service):
<nowiki>{"error":"not enough credits"}</nowiki>
===getUserKeyInfo===
Get information about user key
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:
<nowiki>https://api.acestream.net/reseller?method=getUserKeyInfo ↵
&api_version=1.0 ↵
&sign=5e0fc46d908e5f224ce9fce9f6a83dd6b3502cc0</nowiki>
response (no services):
<tt>{"services":[]}</tt>
response (there are services):
<nowiki>{"services": [
{"id": "noAds", "validFrom": 1374673235, "validTo": 1445089235, "enabled": true},
===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 ↵
&sign=99982a11708ef4a80e12f1ca845d314340db8869</nowiki>
response:
<tt>{
"userKey": "c7456d962209ce22a8edd0c788940a15792bc575",
}</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
