Joomag API 2.0 Dokumentation

Erste Schritte

Integrieren Sie Ihre Webseite oder APP mit Joomag, indem Sie unsere einfache REST API verwenden. Mit unserer API können Sie einfache Calls tätigen, um Magazine zu erstellen, sie in Ihre Webseite einzubetten, Abonnements auszuliefern und vieles mehr.
Wir haben versucht den Registrierungs- und On-Broadcastingprozess so intuitiv wie möglich zu gestalten. Dennoch müssen ein paar Dinge erwähnt werden.

Wo ist der API/Secret Key?

Sie finden Ihre API und Secret Keys im API Teil der Kontoeinstellungen Seite

Authentifizierung

Joomag API Calls müssen einen HTTP Request Header Key mit dem Wert Ihrer Account API Key Authentifizierung enthalten.

Beispiel:

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

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

Signierte API Calls

Manche API Calls müssen von Ihrem Account Secret Key signiert sein. Diese Calls müssen den HTTP request header sig mit dem Wert der Call Signatur haben. Befolgen Sie folgende Schritte, um eine Signatur für eine Nachricht zu erstellen.

  • Sortieren Sie alle Parameter des Calls nach Feld Name in alphabetischer Reihenfolge.
  • Erstellen Sie einen Parameter String indem Sie Parameterwerte verknüpfen.
  • Verknüpfen Sie HTTP Methode, Fordern Sie URO und Parameter String an.
  • Berechnen Sie einen Signaturwert indem Sie HMAC mit SHA256 Algorithmus auf den resultierenden String nutzen. Nutzen Sie Ihren Accound Secret Key als Key Wert.

Beispiel:

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