Zum Inhalt springen

Die REST API nutzen

JSON Web Token erstellen

Für den Aufruf der REST API ist ein Access-Token erforderlich. Wir verwenden ein JSON Web Token was im Authorization-Feld als Bearer-Token übertragen wird. Damit Sie ein individualisiertes Token erhalten legen Sie bitte einen neuen Benutzer mit API Rechten an:

API User anlegen

Das Token finden Sie nun bei den Details zum neu angelegten Benutzer:

Bearer Token

Verwenden Sie nun dieses Token im Authorization Header um einen API Aufruf durchzuführen.

Authorization: Bearer 1f319b0ec6aa2975e1a1d5464637949c

Methoden und Objekte

Unsere REST API wird bei Bedarf um weitere Methoden und Objekte erweitert. Die folgenden Objekte stehen aktuell zur Verfügung.

ObjektURIMethoden
Empfänger/subscriptionEmpfänger auslesen, anmelden und abmelden
Verteiler/groupVerteiler abrufen und Einstellungen ändern
Personalisierung/personalizationPersonalisierungen anlegen und abrufen
Blacklist/blacklistEinträge abrufen, hinzufügen und löschen
Newsletter/newsletterNewsletter abrufen und erstellen

Eine detaillierte Beschreibung aller Methoden und Parameter finden Sie in der Dokumentation auf Swaggerhub . Hier können Sie auch direkt die API ausprobieren. Nutzen Sie dazu die Funktion "Authorize" oben rechts und dann "Tryout" bei der jeweiligen Methode.

Swaggerhub Dokumentation

Beispiel

Ein einfaches Beispiel zum Abruf aller Verteiler könnte wie folgt aussehen:

$authorization = array('Authorization: Bearer 1f319b0ec6aa2975e1a1d5464637949c');
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://api.newstroll.de/group');
curl_setopt($curl, CURLOPT_HTTPHEADER, $authorization);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);
print_r(json_decode($response, true));

Das Ergebnis sieht dann wie folgt aus:

Array
(
    [0] => Array
        (
            [id] => 74415
            [titel] => newstroll.de
            [name] => Kunden
            [publicgroup] => N
            [signonmail] => Y
            [commitment] => Y
            [signoffmail] => Y
            [signoffblist] => Y
            [commitsignon] => Y
        )
)

Tools

Wir empfehlen Swagger.io oder Postman als Entwicklungstools.