Müşterinin doğrulama durumunu alma

  • Makale
  • Okumak için 2 dakika

İş ortağı, isteğe bağlı olarak müşteri doğrulama durumunu alabilir.

Önkoşullar

  • Kimlik doğrulamasında açıklandığı gibi kimlik İş Ortağı Merkezi bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamasını destekler.

  • Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız bu kimliği panoda İş Ortağı Merkezi. İş Ortağı Merkezi'den CSP'yi ve ardından Müşteriler'i seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında Müşteri Hesabı Bilgileri bölümünde MicrosoftKimliği'ne bakın. Microsoft Kimliği, müşteri kimliği (customer-tenant-id) ile aynıdır.

C#

Müşterinin hesabı için doğrulama durumunu almak için, önce almak için ValidationType'ı temsil eden bir enum oluşturun. Ardından, müşteri tanımlayıcısıyla IAggregatePartner.Customers.ById yöntemini çağırın. Ardından ValidationStatus özelliğini kullanarakIValidationStatus arabirimini alın. Son olarak, GetValidationStatus() giriş parametresi olarak doğrulama türü sabit sabit GetValidationStatusAsync() değişkeniyle veya çağrısında bulundurun.

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

Örnek:Konsol Örnek Uygulaması. Project:SdkSamples Sınıfı:GetValidationStatus.cs

REST İsteği

İstek söz dizimi

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

URI parametresi

Doğrulama durumunu almakta olduğunu müşteriyi belirtmek için aşağıdaki sorgu parametresini kullanın.

Ad Tür Gerekli Açıklama
{customer-id} guid Y Değer, müşteri belirtmenize olanak sağlayan GUID biçiminde bir CustomerTenantId değeridir.
tür string Y Alınan doğrulama durumunun türü.

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

REST yanıtı

Her yanıt, başarılı veya başarısız olduğunu gösteren bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İŞ ORTAĞı MERKEZI REST hata kodları.

Yanıt alanları

Alan Tür Açıklama Notlar
Tür Sabit listesi Doğrulama bilgi türü Doğrulama türüyle aynı veriler. Doğrulama türü, hesabı yanıt türü olarak döndürür.
Durum Sabit listesi Doğrulama durumu Kullanılabilir durum: Bilinmiyor, UnderReview, Allowed, NotAllowed, Not Ready
En Son Güncelleştirme Zamanı DateTime UTC olarak son durum güncelleştirme zamanı

Yanıt örnekleri

İzin verilen durum

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

Gözden geçirme durumunda

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

NotAllowed durumu

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

Bilinmeyen durum

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

Hazır Değil durumu

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

404 bulunamadı hatası

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

Satın alma uygunluğu

Hesabı aşağıdaki durumlardan herhangi biri olduğunda müşterinin işlemleri engellenir:

  • UnderReview
  • Notallowed
  • Bilinmiyor

Müşterinin işlemleri aşağıdaki koşulları karşılarken engellenmiş olmayacaktır:

  • Müşterinin İzin verilen durumu var
  • Müşterinin hesap durumu yok