Pobieranie stanu weryfikacji klienta

Partner może pobrać stan weryfikacji klienta na żądanie.

Wymagania wstępne

• Ustanowione poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń użytkownika i aplikacji.

• Identyfikator klienta (identyfikator dzierżawy klienta). Jeśli nie znasz identyfikatora klienta, możesz go wyszukać 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 Firmy Microsoft jest taki sam jak identyfikator klienta (identyfikator dzierżawy klienta).

C#

Aby pobrać stan weryfikacji klienta dla swojego konta, najpierw utwórz wyliczenie reprezentujące wartość ValidationType do pobrania. Następnie wywołaj metodę IAggregatePartner.Customers.ById identyfikatorem klienta. Następnie użyj właściwości ValidationStatus , aby pobrać interfejs IValidationStatus . Na koniec wywołaj GetValidationStatus() zmienną wyliczeniową typu walidacji lub GetValidationStatusAsync() za pomocą zmiennej wyliczenia jako parametru wejściowego.

var validationTypeToFetch = ValidationType.Account;
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).ValidationStatus.GetValidationStatus(validationTypeToFetch);

Przykład: przykładowa aplikacja konsoli. Projekt: SdkSamples , klasa: GetValidationStatus.cs

Żądanie REST

Składnia żądania

Metoda	URI
GET	{baseURL}/v1/customers/{customer-id}/validationStatus?type=account

Parametr identyfikatora URI

Użyj następującego parametru zapytania, aby określić klienta, dla którego pobierasz stan weryfikacji.

Nazwa	Typ	Wymagane	Opis
{customer-id}	guid	Y	Wartość to identyfikator GUID sformatowany CustomerTenantId, który umożliwia określenie klienta.
typ	ciąg	Y	Typ stanu weryfikacji do pobrania.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Odpowiedź REST

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.

Pola odpowiedzi

Pole	Typ	Opis	Uwagi
Typ	Wyliczenie	Typ informacji o weryfikacji	Te same dane co typ weryfikacji. Typ weryfikacji zwraca konto jako typ odpowiedzi.
Stan	Wyliczenie	Stan weryfikacji	Dostępne stany: Nieznany, UnderReview, Allowed, NotAllowed, Not Ready
Czas najnowszej aktualizacji	ciąg	czas ostatniej aktualizacji stanu w formacie UTC

Przykłady odpowiedzi

Dozwolony stan

{
    "type": "account",
    "status": "Allowed",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

W stanie przeglądu

{
    "type": "account",
    "status": "UnderReview",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

Stan NotAllowed

{
    "type": "account",
    "status": "NotAllowed",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

Nieznany stan

{
    "type": "account",
    "status": "Unknown",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

Stan Nie gotowe

{
    "type": "account",
    "status": "Not Ready",
    "lastUpdateDateTime": "2021-07-14T18:02:00"
}

Błąd 404 nie znaleziono

{
    "code": 600074,
    "message": "Account Status for the customer, {customer-id} was not found.",
    "description": "Account Status for the customer, {customer-id} was not found.",
    "errorName": "AccountStatusNotFound",
    "isRetryable": false,
    "errorMessageExtended": "InternalErrorCode=600074"

Uprawnienia do zakupu

Transakcje klienta będą blokowane, gdy jego konto ma dowolny z poniższych stanów:

• W obszarze Przegląd
• Notallowed
• Nieznane

Transakcje klienta nie będą blokowane po spełnieniu następujących warunków:

• Klient ma stan Dozwolone
• Klient nie ma stanu konta