Documentação Joomag API 2.0

Começando

Integre seu site ou aplicativo com a Joomag utilizando nossa simples REST API. Usando nossa API você pode fazer chamadas simples para criar revistas, inseri-las em seu site, distribuir assinaturas e muito mais.
Tentamos deixar o processo de registro e de acesso a conta o mais intuitivo possível. No entanto, há algumas coisas que gostaríamos de mencionar.

Onde está a API/Chave Secreta?

Você pode encontrar sua API e Chaves Secretas em API seção da página Configurações da Conta

Autenticação

As chamadas API da Joomag devem conter a chave de pedido de cabeçalho HTTP com o valor da chave API para fins de autenticação.

Exemplo:

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

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

Assinando chamadas API

Algumas chamadas API exigem quem sejam assinadas pela chave secreta da sua conta. Estas chamadas contem assinatura de cabeçalho de pedido HTTP com valor da assinatura de chamada. Para criar uma assinatura para uma mensagem, siga os seguintes passos

  • Organizar todos os parâmetros da chamada pelo nome do campo em ordem alfabética.
  • Criar uma cadeia de parâmetros pelo encadeamento de valores de parâmetros.
  • Encadear método HTTP, solicitar cadeia de URI e de parâmetros.
  • Calcule o valor de uma assinatura usando o HMAC com o algoritmo SHA256 na cadeia resultante e usando a chave secreta da sua conta como valor de chave.

Exemplo:

$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);