1. Home
  2. Dokumente
  3. Bonuspunkte Plugin für JT...
  4. Konfiguration
  5. Rest API

Rest API

Die Rest API eignet sich ideal, um Bonuspunkte zu setzen oder zu löschen.

Die Rest API setzt auf die JTL-Shop interne Rest-API auf. Um die Rest API nutzen zu können, ist ein Token nötig.

Weitere Informationen zur JTL-Shop Rest API findest du unter folgendem Link: https://go.x-volution.de/1Q1xp

Die Webhook URL setzt sich wie folgt zusammen, wobei DEINE_URL durch die Webshop URL ausgetauscht wird:

				
					https://DEINE_URL/api/v1/rewardPoints
				
			

Mittels der Methode kann man festlegen, was genau gemacht werden soll.

GET: Ein GET Request holt einen Eintrag ab und gibt Ihn als JSON zurück.
POST: Mittels der POST Methode kann man einen manuellen Eintrag anlegen (analog zu der Nutzung mittels Backend)
DELETE: Ein DELETE macht den Bonuspunkt ungültig (Eintrag bleibt in der History erhalten, aber die Punkte können nicht mehr verwendet werden).
PUT: Ein PUT ändert einen Eintrag (z.b. kann man so Punkte von Ausstehend zu Verfügbar ändern).

In PHP könnte das wie folgt aussehen:

				
					<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://DEINE_URL/api/v1/rewardPoints/68',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'x-api-key: ** JTL API-KEY HIER EINFUEGEN **,
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
			

Dies würde den Eintrag für die Bonuspunkte zur Bestellung 68 abolen.

Wir möchten anhand einem Beispiel aus der JTL-WAWI heraus erklären, wie man mittels JTL-Workflows Bonuspunkte entfernen kann, wenn eine Retoure abgeschlossen wurde.