Joomag API 2.0 文件

开始

使用我们的简单REST API,通过Joomag整合您的网站或APP。使用我们的API,您可以提出创建杂志的简单要求,发送订阅等等
我们会尽量让注册和熟悉过程简单直观。不过,需要注意几方面问题

API/密钥在哪里?

您可以在账号设定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 调用需要使用您账户机密钥匙签字。这些调用应该包括一个有调用签字的 HTTP 请求头。为了给一条消息创建签名,应该采取以下步骤

  • 按字母顺序按字母顺序排序调用的所有参数。
  • 通过将参数值串联在一起来创建参数字符串。
  • 连接HTTP方法,请求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);