Asynchronicznie uzyskaj kwalifikacje klienta
Jak asynchronicznie uzyskać kwalifikacje klienta.
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Identyfikator klienta (
customer-tenant-id
). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id
).
C#
Aby uzyskać kwalifikacje klienta, wywołaj metodę IAggregatePartner.Customers.ById przy użyciu identyfikatora klienta. Następnie użyj właściwości Qualification, aby pobrać interfejs ICustomerQualification. Na koniec należy zadzwonić GetQualifications()
do klienta lub GetQualificationsAsync()
pobrać kwalifikacje klienta.
// IAggregatePartner partnerOperations;
// string customerId;
var customerQualifications = partnerOperations.Customers.ById(customerId).Qualification.GetQualifications();
Przykład: przykładowa aplikacja konsoli. Projekt: SdkSamples , klasa: GetCustomerQualifications.cs
Żądanie REST
Składnia żądania
Metoda | Identyfikator URI żądania |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/qualifications HTTP/1.1 |
Parametr identyfikatora URI
W tej tabeli wymieniono wymagany parametr zapytania, aby uzyskać wszystkie kwalifikacje.
Imię i nazwisko/nazwa | Pisz | Wymagani | opis |
---|---|---|---|
identyfikator dzierżawy klienta | string | Tak | Ciąg sformatowany za pomocą identyfikatora GUID, który identyfikuje klienta. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
Brak.
Przykład żądania
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
Odpowiedź REST
Jeśli ta metoda powiedzie się, zwraca kolekcję kwalifikacji w treści odpowiedzi. Poniżej przedstawiono przykłady wywołania GET dla klienta z kwalifikacjami edukacyjnymi.
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.
Przykłady odpowiedzi
Zatwierdzona
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",
}
]
W trakcie przeglądu
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
}
]
Zabronione
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
}
]
Przykłady jednostek należących do państwa
Przykładowa jednostka będąca własnością państwa za pośrednictwem post
//SOE
POST {customer_id}/qualifications
{
"qualification": "StateOwnedEntity"
}
//
Jednostka należąca do państwa za pośrednictwem przykładu Uzyskiwanie kwalifikacji
//SOE:
GET {customer_id}/qualifications
[
{
"qualification": "StateOwnedEntity"
}
]
Jednostka państwowa za pośrednictwem uzyskiwania kwalifikacji z wykształceniem
GET {customer_id}/qualifications
[
{
"qualification": "Education",
"vettingStatus": "Approved"
},
{
"qualification": "StateOwnedEntity"
}
]
Jednostka będąca własnością państwa za pośrednictwem uzyskiwania kwalifikacji z GCC
GET {customer_id}/qualifications
[
{
"qualification": "GovernmentCommunityCloud",
"vettingStatus": "Approved",
"vettingCreateDate": "2021-05-06T19:59:56.6832021+00:00"
},
{
"qualification": "StateOwnedEntity"
}
]
Powiązane artykuły
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla