Widerrufen von Data Cloud-Zugriffstoken

Verwenden Sie den /revoke-Endpunkt, um ein zuvor ausgestelltes Data Cloud-Zugriffstoken ungültig zu machen. Dieser API-Endpunkt verwendet eine POST, um das Token zu widerrufen. Der Anforderungstext muss das zu widerrufende Token als erforderlichen Parameter mit dem Namen token enthalten.

Endpunkt-URL

https://{datacloud_instance_url}/services/a360/revoke

Anforderungskopfzeilen

• Authorization: Ein gültiges Data Cloud-Token. Dies kann das Token sein, das Sie widerrufen, oder ein anderes autorisiertes Token.
• Content-Type: Muss 'application/x-www-form-urlencoded sein.

Anforderungstext

• token: Eine Zeichenfolge, die das zu widerrufende Token identifiziert.

Beispiel-Curl-Anforderung

Der folgende curl-Befehl zeigt und zeigt ein Beispiel zum Widerrufen eines Data Cloud-Zugriffstokens:

curl -X POST "https://{datacloud_instance_url}/services/a360/revoke" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer {valid_token}" \
-d "token={datacloud_access_token_to_revoke}"
   

Antwortcodes

Die API gibt einen Antwortcode zurück, um das Ergebnis der Anforderung anzugeben. Er gibt den Antworttext im application/json-Format zurück.

{
 "error": "invalid_request", 
"error_description": "The provided token is malformed or improperly encoded."
 } 

{ 
"error": "unauthorized_client", 
"error_description": "The authenticated client is not authorized to revoke the token"
 } 

{ 
"error": "service_unavailable", 
"error_description": "The service is temporarily unavailable. Please retry later."
 }