Share via

De kwalificatie van een klant asynchroon verkrijgen

  • Artikel

Hoe u de kwalificaties van een klant asynchroon kunt verkrijgen.

Vereisten

  • Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

  • Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het 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).

C#

Als u de kwalificaties van een klant wilt ophalen, roept u de methode IAggregatePartner.Customers.ById aan met de klant-id. Gebruik vervolgens de eigenschap Kwalificatie om een ICustomerQualification-interface op te halen. Roep ten slotte aan GetQualifications() of GetQualificationsAsync() haal de kwalificaties van de klant op.

// IAggregatePartner partnerOperations;
// string customerId;
var customerQualifications = partnerOperations.Customers.ById(customerId).Qualification.GetQualifications();

Voorbeeld: Consolevoorbeeld-app. Project: Klasse SdkSamples: GetCustomerQualifications.cs

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameter

Deze tabel bevat de vereiste queryparameter om alle kwalificatie op te halen.

Naam Type Vereist Beschrijving
klant-tenant-id tekenreeks Ja Een tekenreeks met GUID-indeling die de klant identificeert.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68

REST-antwoord

Als dit lukt, retourneert deze methode een verzameling kwalificaties in de antwoordtekst. Hieronder ziet u voorbeelden van de GET-oproep aan een klant met de opleidingskwalificatie .

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Antwoordvoorbeelden

Worden goedgekeurd

HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
    {
        "qualification": "Education",
        "vettingStatus": "Approved",
    }
]

In review

HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
    {
        "qualification": "Education",
        "vettingStatus": "InReview",
        "vettingCreatedDate": "2020-12-03T10:37:38.885Z" // UTC
    }
]

Geweigerd

HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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
    }
]

Voorbeelden van entiteiten in staatseigendom

Entiteit in staatseigendom via POST-voorbeeld


//SOE
POST {customer_id}/qualifications
{
"qualification": "StateOwnedEntity"
}

//

Entiteit in staatseigendom via een voorbeeld van kwalificaties ophalen


//SOE:
GET {customer_id}/qualifications
[
    {
        "qualification": "StateOwnedEntity"
    }
]

Entiteit in staatseigendom via Kwalificaties ophalen met onderwijs


GET {customer_id}/qualifications
[
    {
        "qualification": "Education",
        "vettingStatus": "Approved"
    },
{
        "qualification": "StateOwnedEntity"
    }
]

Entiteit in staatseigendom via Kwalificaties ophalen met GCC


GET {customer_id}/qualifications
[
    {
        "qualification": "GovernmentCommunityCloud",
        "vettingStatus": "Approved",
        "vettingCreateDate": "2021-05-06T19:59:56.6832021+00:00"
    },
{
        "qualification": "StateOwnedEntity"
    }
]