Reseller API
Contents
Общее описание API
Запросы API отправляются методом HTTP-GET на такие адреса:
- тестовый режим: https://api.sandbox.acestream.net/reseller
- боевой режим: https://api.acestream.net/reseller
Ответы на запросы приходят в формате json.
Если при обработке запроса возникла ошибка, будет отослан ответ такого вида:
{"error":"error descrtiption"}
Ответы за успешно обработанные запросы зависят от вызываемого метода.
Обязательные общие параметры для всех запросов
- method - вызываемый метод API
- api_key - ключ клиента API
- api_version - поддерживаемая версия API (текущая версия: 1.0)
- app - идентификатор маркета
- sign - цифровая подпись запроса
Алгоритм формирования цифровой подписи
- создается массив строк вида "название_параметра=значение_параметра"
- полученный массив сортируется
- элементы отсортированного массива объединяются в строку с разделителем "#"
- к полученной строке добавляется секретный ключ клиента API
- подписью является sha1-хеш от полученной строки (в шестнадцатеричном представлении, 40 символов, маленькими буквами)
Код на PHP:
function makeSignature(array $params, $apiSecret) { $checkParams = array(); foreach($params as $k => $v) { $checkParams[] = $k . '=' . $v; } sort($checkParams); $payload = join('#', $checkParams); $sign = sha1($payload . $apiSecret); return $sign; }
Методы API
getServiceCost
Получить стоимость опции
параметры:
- service (string) - идентификатор опции
- period (string) - идентификатор периода
поля в ответе:
- cost (decimal) - стоимость опции на указанный период в EUR
пример запроса:
https://api.acestream.net/reseller?method=getServiceCost ↵ &api_version=1.0 ↵ &api_key=be6f66e0848528139583b567fb222215444fc8ac ↵ &app=9_50gh753t6uscog88800kcksw04s0o0wccscco8kgsogwkocwgw ↵ &service=noAds ↵ &period=m1 ↵ &sign=45c84ceffd3ec443586e8f4666b28abde8400768
ответ:
{"cost":1}
activateService
Активировать опцию для пользователя
параметры:
- user_key (string) - ключ пользователя
- service (string) - идентификатор опции
- period (string) - идентификатор периода
поля в ответе:
- validFrom (unix timestamp) - с какого времени опция активна
- validTo (unix timestamp) - до какого времени опция активна
пример запроса:
https://api.acestream.net/reseller?method=activateService ↵ &api_version=1.0 ↵ &api_key=be6f66e0848528139583b567fb222215444fc8ac ↵ &app=9_50gh753t6uscog88800kcksw04s0o0wccscco8kgsogwkocwgw ↵ &user_key=a455865e5800fd7efab75f2b4852fc2497f9fc39 ↵ &service=noAds ↵ &period=m1 ↵ &sign=c4df772a4a41ad7bbb4d7d07e46cad5e3622c59e
ответ (успешная активация опции):
{"validFrom":1376048972,"validTo":1378640972}
ответ (на балансе реселлера недостаточно средств для активации опции):
{"error":"not enough credits"}
getUserKeyInfo
Получить информацию о ключе пользователя
параметры:
- user_key (string) - ключ пользователя
поля в ответе:
- services (array) - массив опций, привязанных к данному ключу пользователя. Каждая опция описывается такими полями:
- id (string) - идентификатор опции
- validFrom (unix timestamp) - с какого времени опция активна
- validTo (unix timestamp) - до какого времени опция активна
- enabled (boolean) - активна ли опция в данный момент
пример запроса:
https://api.acestream.net/reseller?method=getUserKeyInfo ↵ &api_version=1.0 ↵ &api_key=be6f66e0848528139583b567fb222215444fc8ac ↵ &app=9_50gh753t6uscog88800kcksw04s0o0wccscco8kgsogwkocwgw ↵ &user_key=8fb311be3836b04f61817dbf8a23c05739ebb13e ↵ &sign=5e0fc46d908e5f224ce9fce9f6a83dd6b3502cc0
ответ (нет опций):
{"services":[]}
ответ (есть опции):
{"services": [ {"id": "noAds", "validFrom": 1374673235, "validTo": 1445089235, "enabled": true}, {"id": "premium", "validFrom": 1374858187, "validTo": 1448301787, "enabled": true} ]}
Идентификаторы опций
- noAds - опция "No ADs" (отключение рекламы Ace Stream)
- premium - опция "Premium Streams" (доступ к премиум-контенту)
Идентификаторы периодов
- m1 - 30 дней
- y1 - 365 дней