Описание API

mizaider

DevsAid Team
Команда форума
Модератор
18 Май 2016
28.386
5.966
140
Питер
#1
Адрес api для работы с панелью
Код:
http://license.devsaid.com/api/
https://license.devsaid.com/api/
Запросы на API отправляются в формате JSON. Например:
PHP:
<?
    $ch = curl_init();
    $request = array(
        'domain'    => $_SERVER['SERVER_NAME'],
        'product_id'     => '585615212',
        'user_id'     => '323038434',
        'product_ver'     => '2.0.788',
        'get_key'     => '1'
    );
    $options = array(
        CURLOPT_HTTPHEADER => array('Content-Type: application/json'),
        CURLOPT_HEADER => 0,
        CURLOPT_SSL_VERIFYPEER => 0,
        CURLOPT_CONNECTTIMEOUT => 3,
        CURLOPT_TIMEOUT => 15,
        CURLOPT_POST => 1,
        CURLOPT_POSTFIELDS => json_encode($request),
        CURLOPT_RETURNTRANSFER => 1
    );
    $ch = curl_init("http://license.devsaid.com/api/");
    curl_setopt_array($ch, $options);
    curl_exec($ch);
    curl_close($ch);
?>
Для валидации домена
Для проверки лицензии должны быть обязательно переданы следующие параметры:
  • domain - Проверяемый домен
  • user_id - ID пользователя панели
  • product_id - ID продукта в панели
Не обязательные параметры:
  • license_key - Ключ активации. Ключ становится активированным на домен который передан выше. (Если передан ключ, то последующие параметры игнорируются, api переходит в режим активации ключа)
  • num_order - Номер заказа или платежки
  • buy_in - Место покупки продукта
  • get_key - Возвращать ли в ответе содержимое файла *.lic
  • product_ver - ID версии продукта в панели
Ответ возвращается в формате JSON и содержит:
  • Код ответа - Обязательно
  • Сообщение - Обязательно
  • Хеш ответа - Обязательно
  • Подпись ответа - Опционально
  • Тип подписи ответа - Опционально
  • Все данные о лицензии в формате JSON - Опционально
  • Содержимое файла *.lic - только если передан get_key и статус ответа 200
Ответ может быть зашифрован согласно настройкам в панели.

Коды ответа и сообщения для активации ключа:
  • 301 - Неверный ключ
  • 302 - Ключ уже активирован
  • 200 - Домен активирован
Коды ответа и сообщения для проверки лицензии:
  • 200 - Домен активен
  • 201 - Триальное время
  • 202 - Продукт в режиме песочницы
  • 301 - Пользователь не существует
  • 302 - У продукта есть версии, укажите их
  • 303 - Несоответсвие версии и id продукта
  • 304 - Продукт не найден либо не принадлежит указанному пользователю
  • 305 - Лицензия истекла
  • 306 - Домен не активен
  • 307 - Домен в процессе активации
  • 308 - Домен заблокирован
  • 309 - Домен не активен
  • 310 - Домена нет в базе
  • 403 - Место покупки или номер заказа\чека не распознаны.
 
Добавлены необязательные параметры num_order и buy_in.
В случае если переданные параметры отличаются от тех что указаны в панели лицензирования для переданного домена, возвращается ошибка 403 - Место покупки или номер заказа\чека не распознаны.
Если в панели лицензирования данные не указаны то они заполняются из переданных.
 
Добавлен параметр get_key.
Если передано get_key=1 то в ответе сервера в поле lic_key будет содержимое *.lic файла для этого домена. Передается только если код ответа 200.

Для управления лицензиями в панели


Например:
PHP:
<?
$ch = curl_init();
$request = array(
    'api_key'     => '8gsdg09s8d7f6as8f980-as9g78sg',
    'user_id'     => '687324',
    'handler'     => 'add_license',
    'parameters'   => array(
        'product_id'  => '34534567',
        'domain'  => array ('domain.ru','test.ru')
        'status'  => 'processing',
        'comments'  => base64_encode('Тест'),
        'expiry_date' => (time() + 220752000),
        'customer_email' => $email,
        'buy_in'   => $market,
        'num_order'   => $check
    )
);
$options = array(
    CURLOPT_HTTPHEADER => array('Content-Type: application/json'),
    CURLOPT_HEADER => 0,
    CURLOPT_SSL_VERIFYPEER => 0,
    CURLOPT_CONNECTTIMEOUT => 3,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_POST => 1,
    CURLOPT_POSTFIELDS => json_encode($request),
    CURLOPT_RETURNTRANSFER => 1
);
$ch = curl_init("http://license.devsaid.com/api/");
curl_setopt_array($ch, $options);
curl_exec($ch);
curl_close($ch);
?>
Для работы с лицензиями должны быть переданы следующие параметры:

Обязательные параметры:
  • api_key - Ключ который можно создать в панели. У ключа должны быть права на выполнение действия.
  • user_id - ID пользователя панели.
  • handler - Действие
    • add_license - Для добавления лицензии с любым статусом
    • add_license_pending - Для добавления лицензии только с статусом "В процессе"
    • suspend - Для блокировки лицензии
    • unsuspend - Для разблокировки лицензии
    • change_status - Для смены статуса лицензии
    • change_expiry_date - Для продления лицензии
  • parameters - Параметры для действия в массиве
Далее разбор параметров для разных действий:
  1. Для добавления лицензии:
    • product_id - ID продукта для которого добавляется лицензия
    • comments - Комментарий к лицензии передается в base64
    • license_key - Ключ который может быть использован для активации лицензии, может быть пустым и будет сгенерирован системой по маске в настройках
    • domain - Домен для которого создаётся лицензия, в случае если создаётся ключ для активации значение должно быть "*", может быть передан массив из доменов
    • expiry_date - Дата окончания действия лицензии, задается в секундах с начала эпохи
    • status - Статус лицензии, может иметь следующие значения "active,inactive,processing,inactive,suspended", в случае если создаётся ключ для активации значение должно быть "processing"
    • customer_email - Email клиента для уведомлений о завершении срока действия лицензии
    • num_order - Номер чека или заказа
    • buy_in - Место покупки продукта
  2. Для добавления лицензии только с статусом "В процессе":
    • product_id - ID продукта для которого добавляется лицензия
    • comments - Комментарий к лицензии передается в base64
    • license_key - Ключ который может быть использован для активации лицензии, может быть пустым и будет сгенерирован системой по маске в настройках
    • domain - Домен для которого создаётся лицензия, может быть передан массив из доменов
    • expiry_date - Дата окончания действия лицензии, задается в секундах с начала эпохи
    • status - Статус лицензии, только "processing". В случае если передан другой, то ошибка.
    • customer_email - Email клиента для уведомлений о завершении срока действия лицензии
    • num_order - Номер чека или заказа
    • buy_in - Место покупки продукта
  3. Для блокировки лицензии:
    • domain - Домен
  4. Для разблокировки лицензии:
    • domain - Домен
  5. Для смены статуса лицензии:
    • domain - Домен
    • status - Статус
  6. Для продления лицензии:
    • domain - Домен
    • time_stamp - Время до которого действует лицензия
Коды ответа работы с лицензиями:
Общие ошибки:
  • 301 - Неверный API ключ
  • 302 - Нет прав для действия
  • 303 - Не передан продукт в параметрах
  • 304 - Продукт не найден либо не принадлежит указанному пользователю
  • 305 - Не передан домен в параметрах
  • 500 - Ошибка базы данных
  1. Для добавления лицензии:
    • 306 - Неверный срок действия лицензии. Время указывается с начала эпохи.
    • 307 - Email неверен
    • 308 - Домен уже есть в базе
    • 309 - Домен уже присутствует в другой лицензии на этот продукт
    • 200 - Лицензия добавлена
  2. Для добавления лицензии только с статусом "В процессе":
    • 306 - Неверный срок действия лицензии. Время указывается с начала эпохи.
    • 307 - Email неверен
    • 308 - Домен уже есть в базе
    • 309 - Ключ позволяет добавлять лицензии только со статусом "В процессе"
    • 310 - Домен уже присутствует в другой лицензии на этот продукт
    • 200 - Лицензия добавлена
  3. Для блокировки лицензии:
    • 306 - Домена нет в базе
    • 307 - Домен уже заблокирован
    • 200 - Лицензия обновлена
  4. Для разблокировки лицензии:
    • 306 - Домена нет в базе
    • 307 - Домен уже активен
    • 200 - Лицензия обновлена
  5. Для смены статуса лицензии:
    • 306 - Не передан статус в параметрах
    • 307 - Домена нет в базе
    • 308 - Неверный статус
    • 200 - Лицензия обновлена
  6. Для продления лицензии:
    • 306 - Неверное время действия лицензии
    • 307 - Домена нет в базе
    • 308 - Неверный формат времени. Время указывается с начала эпохи
    • 200 - Лицензия обновлена
 
Добавлены параметры num_order и buy_in для действия addlicense

Для управления продуктами в панели
Для работы с продуктами должны быть переданы следующие параметры:

Обязательные параметры:
  • api_key - Ключ который можно создать в панели. У ключа должны быть права на выполнение действия.
  • user_id - ID пользователя панели.
  • handler - Действие
    • add_product - Для добавления продукта
  • parameters - Параметры для действия в массиве
Далее разбор параметров для разных действий:
  1. Для добавления продукта:
    • full_name - Полное имя продукта
    • short_name - Короткое имя продукта
    • prod_id_opencartforum - ID продукта на opencartforum.com для автоматического приёма информации об оплате и выдаче ключей.
    • prod_id_livrenet - ID продукта на LivreNet.Ru для автоматического приёма информации об оплате и выдаче ключей. Подробнее.
    • price - Цена в рублях
    • sandbox - Песочница. 1 или 0.
    • trial_time - Триал, в днях. 0 или 1...2...3...
Коды ответа работы с продуктами:
  1. Для добавления продукта:
    • 303 - Ресурс уже привязан к другому пользователю LivreNet.Ru
    • 304 - Ресурс уже привязан к другому пользователю OpencartForum.Com
    • 305 - Переданы не все параметры
    • 200 - Продукт добавлен
 

Похожие темы

Привет!

Мы группа людей которые решили помочь другим в решении их проблем, а так же пользователям с поиском самых свежих и качественных инфопродуктов. За 4 с небольшим месяца мы создали этот форум на который заходят ежедневно тысячи человек и посещаемость постоянно растёт. Мы создали панель лицензирования для защиты PHP скриптов от воровства и SEO панель для мониторинга наших сайтов и выбора верной стратегии их развития. Мы надеемся что то что мы создали пригодится Вам и возможно Вы поможете нам развиваться и совершенствоваться вместе с Вами.

Статистика форума

Темы
320.175
Сообщения
337.013
Пользователи
21.316
Новый пользователь
Александра

Онлайн статистика

Пользователей онлайн
399
Гостей онлайн
3.968
Всего посетителей
4.367

Приложения форума для iOS и Android


У ркн там нет власти ;)
Гостевуха
Помощь Пользователи
    Captain @ Captain: Где моя админка?