Joomag API 2.0 Документация

Начать

Интегрируйте свой сайт или приложение с помощью нашего простого REST API. Используя наш API, Вы сможете делать простые запросы для создания журнала, вставки журнала на сайт, отправки подписок и многое другое.
Мы попытались сделать процесс регистрации и работы максимально интуитивным. Однако, следует упомянуть некоторые моменты.

Где API/Secret key?

Вы можете найти API и секретный ключ в API в разделе Настройки аккаунта

Аутентификация

Joomag API обращения должны содержать ключ заголовка HTTP запроса со значением ключа API Вашего аккаунта.

Например:

$headers = array(
	'key:' . 'api_ValueOfMyJoomagAPIKey',
	// other headers...
);

$ch = curl_init();
// other curl options...
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

Подпись API запросов

Некоторые API запросы требуют подписи секретным ключом аккаунта. Эти запросы должны содержать sig заголовка HTTP запроса со значением подписи. Чтобы создать подпись, выполните следующие шаги.

  • Отсортируйте параметры запроса по полю названия в алфавитном порядке.
  • Создайте строку параметров, сцепив значения параметров.
  • Сцепите HTTP method, запрос URI и строку параметров.
  • Вычислите значение подписи с помощью HMAC с SHA256 алгоритмом в результирующей строке, используйте секретный ключ аккаунта для ключевого значения.

Например:

$method = "POST";
$url = "http://www.joomag.com/api/2.0/magazines";
$params = array('title'=>'My New Magazine', 'description'=>'New Magazine Description');

ksort($params);

$paramsStr = implode($params);
$sig = hash_hmac('sha256', $method . $url . $paramsStr, 'sec_mysecretkey');

$headers = array(
	'key:' . 'api_ValueOfMyJoomagAPIKey',
	'sig:' . $sig,
	// other headers...
);

$ch = curl_init();
// other curl options...
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);