Verwenden eines Tokens - web_services - 23 - 23.1

Spectrum-Webdienste-Handbuch
Product type
Software
Portfolio
Integrate
Product family
Spectrum™ software
Product
Spectrum™ software > Web Services
Version
23.1
ft:locale
de-DE
Product name
Spectrum Technology Platform
ft:title
Spectrum-Webdienste-Handbuch
First publish date
2007
ft:lastEdition
2023-10-25
ft:lastPublication
2023-10-25T07:20:03.279000

Sobald Sie ein Token abgerufen haben, können Sie es zur Authentifizierung auf einem Spectrum Technology Platform-Webservice verwenden. Nehmen Sie das Token hierfür in die Anforderung auf. Dafür stehen Ihnen zwei Möglichkeiten zur Verfügung: als HTTP-Header Authorization oder als HTTP-Header Cookie.

Anmerkung: Die Anzahl der Webservice-Anforderungen, die Sie mit einem Token senden können, unterliegt keinen Begrenzungen. Wenn Sie jedoch ein Token mit Ablauf angefordert haben, läuft das Token nach einer bestimmten Zeit ab. Wenn es sich bei dem Token um ein Sitzungstoken handelt, wird es nach 30 Minuten der Inaktivität ungültig.

Verwendung des Tokens in einem Autorisierungsheader

Verwenden Sie das Token im HTTP-Header Authorization gemäß dem folgenden Format:

Authorization: Bearer Token

Zum Beispiel:

HTTP/1.1  POST http://MySpectrumServer:8080/soap/ValidateAddress Host: MySpectrumServer:8080 Authorization: Bearer eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo

Wenn es sich bei dem Token um ein Sitzungstoken handelt, müssen Sie auch die Sitzungskennung im Header Cookie im folgenden Format angeben:

Cookie: SESSION=SessionID

Zum Beispiel:

HTTP/1.1  POST http://MySpectrumServer:8080/soap/ValidateAddress Host: MySpectrumServer:8080 Authorization: Bearer eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo Cookie: SESSION=fff96e54-1615-4192-96c1-ea2f133ec6eb
Anmerkung: Der Cookie-Name SESSION muss in Großbuchstaben angegeben werden.
Verwenden Sie das Token im Autorisierungsheader gemäß dem folgenden Format:
Authorization: Bearer Token

Zum Beispiel:

POST https://api.precisely.com/identify/identifymailing/v1/soap/validatemailingaddress  Authorization: Bearer eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo
POST https://api.precisely.com/identify/identifyaddress/v1/rest/validatemailingaddress  Authorization: Bearer eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo

Verwendung des Tokens in einem Cookie-Header

Wenn Sie aus Vereinfachungsgründen statt eines Cookie-Headers einen Authorization-Header verwenden, können Sie das Token im folgenden Format im Cookie-Header angeben:

Cookie: spectrum.authentication.token=Token

Zum Beispiel:

HTTP/1.1  POST http://MySpectrumServer:8080/soap/ValidateAddress Host: MySpectrumServer:8080 Cookie: spectrum.authentication.token=eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo

Wenn es sich bei dem Token um ein Sitzungstoken handelt, müssen Sie auch die Sitzungskennung im Header Cookie im folgenden Format angeben:

Cookie: SESSION=SessionID
Anmerkung: Der Cookie-Name SESSION muss in Großbuchstaben angegeben werden.

Zum Beispiel:

HTTP/1.1  POST http://MySpectrumServer:8080/soap/ValidateAddress Host: MySpectrumServer:8080 Cookie: spectrum.authentication.token=eyJlbmMiBMQI4Q0JDLUhTMjU2I5wiYWxnIjoiZGlyIn0..fc6rpRJ-wo Cookie: SESSION=fff96e54-1615-4192-96c1-ea2f133ec6eb