Obtenir la qualification d’un client de façon asynchrone
Comment obtenir les qualifications d’un client de façon asynchrone.
Prérequis
Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.
ID du client (
customer-tenant-id
). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace de partenaires en sélectionnant l’espace de travail Clients, puis le client dans la liste des clients, puis compte. Dans la page Compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id
).
C#
Pour obtenir les qualifications d’un client, appelez la méthode IAggregatePartner.Customers.ById avec l’identificateur du client. Utilisez ensuite la propriété Qualification pour récupérer une interface ICustomerQualification. Enfin, appelez ou GetQualificationsAsync()
récupérez GetQualifications()
les qualifications du client.
// IAggregatePartner partnerOperations;
// string customerId;
var customerQualifications = partnerOperations.Customers.ById(customerId).Qualification.GetQualifications();
Exemple : Exemple d’application de console. Projet : SdkSamples , classe : GetCustomerQualifications.cs
Demande REST
Syntaxe de la requête
Méthode | URI de demande |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/qualifications HTTP/1.1 |
Paramètre d’URI
Ce tableau répertorie le paramètre de requête requis pour obtenir toutes les qualifications.
Nom | Type | Obligatoire | Description |
---|---|---|---|
id-locataire-client | string | Oui | Chaîne au format GUID qui identifie le client. |
En-têtes de requête
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.
Corps de la demande
Aucune.
Exemple de requête
GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
Réponse REST
Si elle réussit, cette méthode retourne une collection de qualifications dans le corps de la réponse. Vous trouverez ci-dessous des exemples d’appel GET sur un client avec la qualification Éducation .
Codes d’erreur et de réussite de la réponse
Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.
Exemples de réponse
Approuvé(e)
HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
{
"qualification": "Education",
"vettingStatus": "Approved",
}
]
En cours de révision
HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
{
"qualification": "Education",
"vettingStatus": "InReview",
"vettingCreatedDate": "2020-12-03T10:37:38.885Z" // UTC
}
]
Refusée
HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
{
"qualification": "Education",
"vettingStatus": "Denied",
"vettingReason": "Not an Education Customer", // example Vetting Reason
"vettingCreatedDate": "2020-12-03T10:37:38.885Z" // UTC
}
]
Exemples d’entités appartenant à l’état
Entité détenue par l’état via l’exemple POST
//SOE
POST {customer_id}/qualifications
{
"qualification": "StateOwnedEntity"
}
//
Entité appartenant à l’état via l’exemple Obtenir des qualifications
//SOE:
GET {customer_id}/qualifications
[
{
"qualification": "StateOwnedEntity"
}
]
Entité détenue par l’état via Obtenir des qualifications avec Éducation
GET {customer_id}/qualifications
[
{
"qualification": "Education",
"vettingStatus": "Approved"
},
{
"qualification": "StateOwnedEntity"
}
]
Entité détenue par l’état via Obtenir des qualifications avec GCC
GET {customer_id}/qualifications
[
{
"qualification": "GovernmentCommunityCloud",
"vettingStatus": "Approved",
"vettingCreateDate": "2021-05-06T19:59:56.6832021+00:00"
},
{
"qualification": "StateOwnedEntity"
}
]