Obtenez l’état de la signature directe d’un client (acceptation directe) de Contrat client Microsoft

Article
03/05/2024

S’applique à : Espace partenaires

Ne s’applique pas à : Espace partenaires géré par 21Vianet | Espace partenaires Microsoft Cloud for US Government

La ressource DirectSignedCustomerAgreementStatus est actuellement prise en charge par l’Espace partenaires uniquement dans le cloud public Microsoft.

Cet article explique comment récupérer l’état de l’acceptation directe d’un client du Contrat client Microsoft.

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 de l’application et de l’utilisateur uniquement.
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 récupérer l’état de l’acceptation directe d’un client du Contrat client Microsoft, appelez la méthode IAggregatePartner.Customers.ById avec l’identificateur du client. Utilisez ensuite la propriété Agreements pour récupérer une interface ICustomerAgreementCollection. Enfin, appelez ou GetDirectSignedCustomerAgreementStatusAsync() récupérez GetDirectSignedCustomerAgreementStatus() l’état.

// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();

Exemple : Exemple d’application de console. Projet : SdkSamples , classe : GetDirectSignedCustomerAgreementStatus.cs

Demande REST

Pour récupérer l’état de l’acceptation directe d’un client de l’Contrat client Microsoft, créez une requête REST pour récupérer directSignedCustomerAgreementStatus pour le client.

Syntaxe de la requête

Utilisez la syntaxe de requête suivante :

Méthode	URI de demande
GET	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Paramètres d’URI

Vous pouvez utiliser les paramètres d’URI suivants avec votre requête :

Nom	Type	Requise	Description
customer-tenant-id	GUID	Oui	La valeur est un CustomerTenantId au format GUID qui vous permet de spécifier l’ID de locataire d’un 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/14876998-c0dc-46e6-9d0c-65a57a6c32ec/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Réponse REST

Si elle réussit, cette méthode renvoie une ressource DirectSignedCustomerAgreementStatus dans le corps de la réponse.

La ressource a une propriété isSigned qui indique l’état de signature directe (acceptation directe) du client.

La valeur true indique que le contrat a été signé (accepté) directement par le client.
La valeur false indique que le contrat n’a pas été signé (accepté) directement par le client.

Codes d’erreur et de réussite de la réponse

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et plus d’informations de débogage.

Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

HTTP/1.1 200 OK
Content-Length: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}

Partager via