De status van de directe ondertekening (directe acceptatie) van de Microsoft-klantovereenkomst van een klant ophalen

Artikel
01/02/2025

van toepassing op: Partnercentrum

Is niet van toepassing op: Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

De DirectSignedCustomerAgreementStatus resource wordt momenteel alleen ondersteund door het Partnercentrum in Microsoft's openbare cloud.

In dit artikel wordt uitgelegd hoe u de status van de directe acceptatie van de Microsoft-klantovereenkomst van een klant kunt ophalen.

Voorwaarden

Referenties zoals beschreven in Partner Center-authenticatie. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens. De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).
De indirecte provider en/of directe factuurpartner moet een actieve verkooprelatie hebben met de klant om de directe ondertekenstatus van de overeenkomst op te halen.

C#

Als u de status van de directe acceptatie van de Microsoft-klantovereenkomst van een klant wilt ophalen, roept u de methode IAggregatePartner.Customers.ById aan met de klant-id. Gebruik vervolgens de eigenschap Agreements om een ICustomerAgreementCollection interface op te halen. Roep tot slot GetDirectSignedCustomerAgreementStatus() of GetDirectSignedCustomerAgreementStatusAsync() aan om de status op te halen.

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

Voorbeeld: Console-voorbeeldapp. Project: SdkSamples Klasse: GetDirectSignedCustomerAgreementStatus.cs

REST-aanvraag

Als u de status van de directe acceptatie van de Microsoft-klantovereenkomst van een klant wilt ophalen, maakt u een REST-aanvraag om de DirectSignedCustomerAgreementStatus voor de klant op te halen.

Aanvraagsyntaxis

Gebruik de volgende aanvraagsyntaxis:

Methode	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

URI-parameters

U kunt de volgende URI-parameters gebruiken met uw aanvraag:

Naam	Type	Vereist	Beschrijving
klant-huurder-id	GUID	Ja	De waarde is een GUID-indeling CustomerTenantId waarmee u de Tenant-ID van een klant kunt opgeven.

Aanvraagkopteksten

Zie Partnercentrum REST-headersvoor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

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

REST-antwoord

Als dit lukt, retourneert deze methode een DirectSignedCustomerAgreementStatus resource in de hoofdtekst van het antwoord.

De resource heeft een isSigned eigenschap die de status van de directe ondertekening (directe acceptatie) van de klant aangeeft.

Een waarde van waar geeft aan dat de overeenkomst rechtstreeks door de klant is ondertekend (geaccepteerd).
Een waarde van onwaar geeft aan dat de overeenkomst niet rechtstreeks is ondertekend (geaccepteerd) door de klant.

Geslaagde antwoorden en foutcodes

Elk antwoord gaat vergezeld van een HTTP-statuscode die aangeeft of het succesvol is of mislukt, en meer informatie voor foutopsporing.

Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Partnercentrum REST-foutcodesvoor de volledige lijst.

Voorbeeld van antwoord

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}

Delen via