UDDI API - discard_authToken

Description

The discard_authToken API call is used to inform an Operator Site that the authentication token is to be discarded, effectively ending the session. Subsequent calls that use the same authToken will be rejected. This message is optional for Operator Sites that do not manage session state or that do not support the get_authToken message.

Upon successful completion, a dispositionReport is returned with a single success indicator. Discarding an expired authToken is processed and reported as a success condition.

Version 2.0 Syntax

<discard_authToken generic = "2.0" 
   xmlns = "urn:uddi-org:api_v2" >
   <authInfo/>
</discard_authToken>

Arguments

authInfo − This required argument is an element that contains an authentication token. Authentication tokens are obtained using the get_authToken API call.

Error Returned

If any error occurs in processing this API call, a dispositionReport element will be returned to the caller within a SOAP Fault. The following error number information will be relevant:

E_authTokenRequired − It signifies that the authentication token value passed in the authInfo argument is either missing or is not valid.