Recuperar el estado de validación de un cliente
Un asociado puede recuperar el estado de una validación del cliente a petición.
Requisitos previos
Credenciales establecidas como se describe en Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.
Un identificador de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El identificador de Microsoft es el mismo que el identificador de cliente (customer-tenant-id).
C#
Para recuperar el estado de validación de un cliente para su cuenta, cree primero una enumeración que represente validationType que se va a recuperar. A continuación, llame al método IAggregatePartner.Customers.ById con el identificador de cliente. A continuación, use la propiedad ValidationStatus para recuperar una interfaz IValidationStatus. Por último, llame a GetValidationStatus()
o GetValidationStatusAsync()
con la variable de enumeración de tipo de validación como parámetro de entrada.
var validationTypeToFetch = ValidationType.Account;
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).ValidationStatus.GetValidationStatus(validationTypeToFetch);
Ejemplo: Aplicación de ejemplo de consola. Project: SdkSamples (Clase): GetValidationStatus.cs
Solicitud REST
Sintaxis de la solicitud
Método | URI |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/validationStatus?type=account |
Parámetro de URI
Use el siguiente parámetro de consulta para especificar el cliente para el que está recuperando el estado de validación.
Nombre | Type | Obligatorio | Descripción |
---|---|---|---|
{customer-id} | guid | Y | El valor es un GUID con formato CustomerTenantId que permite especificar un cliente. |
type | cadena | Y | Tipo de estado de validación que se va a recuperar. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Respuesta REST
Cada respuesta incluye un código de estado HTTP que indica éxito o error y otra información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.
Campos de respuesta
Campo | Tipo | Description | Notas |
---|---|---|---|
Tipo | Enum | Tipo de información de validación | Mismos datos que el tipo de validación. El tipo de validación devuelve la cuenta como el tipo de respuesta. |
Estado | string | Estado de validación | Estados disponibles: Unknown, UnderReview, Allowed, NotAllowed, Not Ready |
Hora de actualización más reciente | string | hora de actualización del último estado en UTC | La fecha y hora ya no se rellena y será una cadena vacía. |
Ejemplos de respuesta
Estado permitido
{
"type": "account",
"status": "Allowed",
"lastUpdateDateTime": ""
}
En estado de revisión
{
"type": "account",
"status": "UnderReview",
"lastUpdateDateTime": ""
}
Estado NotAllowed
{
"type": "account",
"status": "NotAllowed",
"lastUpdateDateTime": ""
}
Estado Desconocido
{
"type": "account",
"status": "Unknown",
"lastUpdateDateTime": ""
}
Estado No listo
{
"type": "account",
"status": "Not Ready",
"lastUpdateDateTime": ""
}
Error 404 no encontrado
{
"code": 600074,
"message": "Account Status for the customer, {customer-id} was not found.",
"description": "Account Status for the customer, {customer-id} was not found.",
"errorName": "AccountStatusNotFound",
"isRetryable": false,
"errorMessageExtended": "InternalErrorCode=600074"
Elegibilidad de compra
Las transacciones del cliente se bloquean si su cuenta tiene alguno de los estados siguientes:
- UnderReview
- No permitidos
- Unknown
Las transacciones del cliente no se bloquean cuando cumplen las condiciones siguientes:
- El cliente tiene el estado Permitido
- El cliente no tiene el estado de la cuenta
Comentarios
https://aka.ms/ContentUserFeedback.
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte:Enviar e ver os comentarios