Operación GetClientAccessToken
Busque información sobre la operación EWS GetClientAccessToken .
La operación GetClientAccessToken obtiene un token de acceso de cliente para una aplicación de correo para Outlook.
Esta operación se introdujo en Exchange Server 2013.
Uso de la operación GetClientAccessToken
La solicitud de operación GetClientAccessToken toma dos argumentos necesarios: el identificador de la aplicación y el tipo de token. Puede usar la operación GetAppManifests para solicitar el identificador de la aplicación.
Encabezados SOAP de la operación GetClientAccessToken
La operación GetClientAccessToken puede usar los encabezados SOAP que se enumeran en la tabla siguiente.
| Nombre de encabezado | Elemento | Descripción |
|---|---|---|
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema de la solicitud de operación. Este encabezado es aplicable a una solicitud. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta. |
Ejemplo de solicitud de operación GetClientAccessToken: Obtención de un token de identidad de autor de llamada
En el ejemplo siguiente de una solicitud de operación GetClientAccessToken se muestra cómo obtener un token de identidad de autor de llamada para una aplicación.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
</soap:Header>
<soap:Body >
<m:GetClientAccessToken>
<m:TokenRequests>
<t:TokenRequest>
<t:Id>1C50226D-04B5-4AB2-9FCD-42E236B59E4B</t:Id>
<t:TokenType>CallerIdentity</t:TokenType>
</t:TokenRequest>
</m:TokenRequests>
</m:GetClientAccessToken>
</soap:Body>
</soap:Envelope>
El cuerpo SOAP de la solicitud contiene los siguientes elementos:
Respuesta correcta de la operación GetClientAccessToken
En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación GetClientAccessToken para obtener un token de identidad de autor de llamada para una aplicación.
Nota:
Los valores de token de este artículo se han acortado para conservar la legibilidad.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="556"
MinorBuildNumber="14"
Version="Exchange2013"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:GetClientAccessTokenResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:GetClientAccessTokenResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Token>
<t:Id>1C50226D-04B5-4AB2-9FCD-42E236B59E4B</t:Id>
<t:TokenType>CallerIdentity</t:TokenType>
<t:TokenValue>eyJ0eXAmv0QitaJg</t:TokenValue>
<t:TTL>479</t:TTL>
</m:Token>
</m:GetClientAccessTokenResponseMessage>
</m:ResponseMessages>
</m:GetClientAccessTokenResponse>
</s:Body>
</s:Envelope>
El cuerpo soap de respuesta contiene los siguientes elementos:
Respuesta de error de la operación GetClientAccessToken
En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación GetClientAccessToken . Se trata de una respuesta a una solicitud para obtener un token de devolución de llamada de extensión sin los permisos adecuados.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="556"
MinorBuildNumber="14"
Version="Exchange2013"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:GetClientAccessTokenResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:GetClientAccessTokenResponseMessage ResponseClass="Error">
<m:MessageText>The caller does not have enough permission for this token request.</m:MessageText>
<m:ResponseCode>ErrorInvalidClientAccessTokenRequest</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:GetClientAccessTokenResponseMessage>
</m:ResponseMessages>
</m:GetClientAccessTokenResponse>
</s:Body>
</s:Envelope>
El cuerpo SOAP de la respuesta de error contiene los siguientes elementos:
Para obtener códigos de error adicionales que son genéricos para EWS y específicos de esta operación, vea ResponseCode.
Vea también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de