API Funktionsübersicht

In diesem Beitrag möchten wir Ihnen zeigen, wie Sie die Funktionen unserer API mithilfe des REST Webservice ansprechen können.

Authentifizierung

HTTP Anfragen an unsere REST API sind durch eine cookie-basierte Authentifizierung geschützt. Um das Session Cookie zu erhalten, müssen Sie die login-Funktion mit Ihrem Benutzernamen und Ihrem Passwort aufrufen.

curl -X POST https://api.klicktipp.com/account/login.json \ --data-urlencode "username=username" \ --data-urlencode "password=XXXXXXXX" \

Im HTTP Response Header  Set-Cookie wird Ihnen der Session Cookie zurückgegeben. Der Session Cookie setzt sich aus einem Namen, dem session_name, und einem Wert, der sessid zusammen. Diesen Session Cookie müssen Sie in allen darauffolgenden Anfragen an unsere API im Header Cookie mitsenden.

Rückgabeformate

Unsere API bietet vier Rückgabeformate an. Sie können sich die Informationen aus Ihrem KlickTipp Konto in PHP, XML oder JSON ausgeben lassen. Um ein Rückgabeformat auszuwählen, fügen Sie den Namen des jeweiligen Datenformats an das Ende der URL an. Um sich also alle Ihre Opt-in-Prozesse in JSON ausgeben zu lassen, rufen Sie die URL „https://api.klicktipp.com/list .json“ auf.

Funktionen

Funktion URL Methode Parameter
login https://api.klicktipp.com/account/login POST username, password
logout https://api.klicktipp.com/account/logout POST keine
subscription_process_index https://api.klicktipp.com/list GET keine
subscription_process_get https://api.klicktipp.com/list/ <listid> GET listid wird in URL benötigt
subscription_process_redirect https://api.klicktipp.com/list/redirect POST listid, email
tag_index https://api.klicktipp.com/tag GET keine
tag_get https://api.klicktipp.com/tag/ <tagid> GET tagid wird in URL benötigt
tag_create https://api.klicktipp.com/tag POST name
tag_update https://api.klicktipp.com/tag/ <tagid> PUT name, tagid wird in URL benötigt
tag_delete https://api.klicktipp.com/tag/ <tagid> DELETE tagid wird in URL benötigt
field_index https://api.klicktipp.com/field GET keine
subscribe https://api.klicktipp.com/subscriber POST email, listid, tagid, fields, smsnumber
unsubscribe https://api.klicktipp.com/subscriber/unsubscribe POST email
tag https://api.klicktipp.com/subscriber/tag POST email, tagids
untag https://api.klicktipp.com/subscriber/untag POST email, tagid
subscriber_index https://api.klicktipp.com/subscriber GET keine
subscriber_get https://api.klicktipp.com/subscriber/ <subscriberid> GET subscriberid wird in URL benötigt
subscriber_search https://api.klicktipp.com/subscriber/search POST email
subscriber_tagged https://api.klicktipp.com/subscriber/tagged POST tagid
subscriber_update https://api.klicktipp.com/subscriber/ <subscriberid> PUT fields, newemail, newsmsnumber, subscriberid wird in URL benötigt
subscriber_delete https://api.klicktipp.com/subscriber/ <subscriberid> DELETE subscriberid wird in URL benötigt
signin https://api.klicktipp.com/subscriber/signin POST apikey, email, fields, smsnumber
signout https://api.klicktipp.com/subscriber/signout POST apikey, email
signoff https://api.klicktipp.com/subscriber/signoff POST apikey, email

Hat dieser Beitrag Dir weitergeholfen?