Načtení stavu ověření zákazníka

  • Článek

Partner může na vyžádání načíst stav ověření zákazníka.

Požadavky

  • Vytvořené přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování jenom pomocí přihlašovacích údajů aplikace a uživatele.

  • ID zákazníka (customer-tenant-ID). Pokud ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte Microsoft ID v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-ID).

C#

Pokud chcete načíst stav ověření zákazníka pro jeho účet, nejprve vytvořte výčet představující typ ValidationType , který se má načíst. Pak zavolejte metodu IAggregatePartner.Customers.ById s identifikátorem zákazníka. Pak použijte Vlastnost ValidationStatus k načtení rozhraní IValidationStatus . Nakonec jako vstupní parametr zavolejte GetValidationStatus() nebo GetValidationStatusAsync() s proměnnou výčtu typu ověření.

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

Ukázka: Ukázková aplikace konzoly. Project: SdkSamples – třída: GetValidationStatus.cs

Požadavek REST

Syntaxe požadavku

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

Parametr identifikátoru URI

Pomocí následujícího parametru dotazu určete zákazníka, pro který načítáte stav ověření.

Název Typ Vyžadováno Popis
{customer-id} guid Y Hodnota je IDENTIFIKÁTOR GUID ve formátu CustomerTenantId, který umožňuje zadat zákazníka.
typ řetězec Y Typ stavu ověření, který se má načíst.

Hlavičky požadavku

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Odpověď REST

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Pole odpovědi

Pole Typ Description Poznámky
Typ Výčet Typ informací o ověření Stejná data jako typ ověření. Typ ověření vrátí jako typ odpovědi účet .
Stav Výčet Stav ověření Dostupné stavy: Neznámý, Podreview, Povoleno, Nepovoleno, Nepřipraveno
Nejnovější čas aktualizace řetězec Čas poslední aktualizace stavu v UTC

Příklady odpovědí

Stav Povoleno

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

Stav kontroly

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

Stav Nepovoleno

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

Neznámý stav

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

Stav Není připraveno

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

Chyba 404 nenalezena

{
    "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"

Způsobilost k nákupu

Transakce zákazníka se zablokují, pokud má jeho účet některý z následujících stavů:

  • Zobrazení v části
  • Nepovoleno
  • Neznámý

Transakce zákazníka nebudou blokovány, pokud splňují následující podmínky:

  • Zákazník má stav Povoleno
  • Zákazník nemá stav účtu