Authentifizierung

 

Header

Die Authentifizierung der SOAP-Schnittstelle läuft über einen Header, der bei jedem Aufruf übergeben werden muss.

Aufbau des Headers

Der Header besteht aus der Benutzer-ID und einem dazugehörigen Token. Ein gültiger Token kann über die Funktion GetAuthentificationToken abgerufen werden. Dies ist die einzige Funktion, die KEINEN Header im Request benötigt.

Abruf und Gültigkeit des Tokens

Der Token ist bis 24:00 Uhr (MEZ) des laufenden Tages gültig.

Tipp

Der Token muss daher pro Benutzer nur einmal täglich abgerufen werden.

Der Abruf des Tokens auf 30 Abrufe täglich pro Benutzer limitiert.

Wichtiger Hinweis zur Schreibweise der XML-Codes

Achten Sie unbedingt auf Groß- bzw. Kleinschreibung.

<SOAP-ENV:Header> <ns2:verifyingToken> <UserID>9</UserID> <Token>810f2edcb7677ab90d53551eca7a2df5</Token> </ns2:verifyingToken> </SOAP-ENV:Header>

Fehlermeldungen

Nachfolgend einige Beispiele zu Fehlermeldungen.

Aufruf ohne Header

Wenn Sie einen Call ohne den oben genannten Header aufrufen, kommt es zu folgender Fehlermeldung:

< ?xml version="1.0" encoding="UTF-8"? > <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>SOAP-ENV:Server</faultcode> <faultstring>Unauthorized Request - Token required</faultstring> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Envelope>

Tipp

Kontrollieren Sie in diesem Fall ihr Request-XML und nehmen Sie ggf. entsprechende Korrekturen vor.

Token abgelaufen

Fehlermeldung, wenn der Token des Benutzers nicht mehr gültig ist. Der Token ist bis 24:00 Uhr des laufenden Tages gültig.

< ?xml version="1.0" encoding="UTF-8"? > <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>SOAP-ENV:Server</faultcode> <faultstring>Unauthorized Request - Invalid Token</faultstring> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Envelope>

Beispiel Request-Call

Nachfolgend ein Beispiel für einen vollständigen Request-Call mit Header:

< ?xml version="1.0" encoding="UTF-8"? > <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://current.plenty.shop/plenty/api/soap/version100/" xmlns:ns2="Authentification" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <SOAP-ENV:Header> <ns2:verifyingToken> <UserID>9</UserID> <Token>810f2edcb7677ab90d53551eca7a2df5</Token> </ns2:verifyingToken> </SOAP-ENV:Header> <SOAP-ENV:Body> <ns1:GetServerTime ></ns1:GetServerTime> </SOAP-ENV:Body> </SOAP-ENV:Envelope>

Nach oben