Müşterinin doğrulama durumunu alma

  • Makale

İş ortağı, talep üzerine müşteri doğrulamasının durumunu alabilir.

Önkoşullar

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

  • Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'ndeMüşteriler çalışma alanını, müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek iş ortağınızı arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliğini bulun. Microsoft kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

C#

Müşterinin hesabının doğrulama durumunu almak için önce alınacak ValidationType değerini temsil eden bir sabit listesi oluşturun. Ardından müşteri tanımlayıcısı ile IAggregatePartner.Customers.ById yöntemini çağırın. Ardından ValidationStatus özelliğini kullanarak bir IValidationStatus arabirimi alın. Son olarak, giriş parametresi olarak doğrulama türü sabit listesi değişkenini veya GetValidationStatusAsync() çağırınGetValidationStatus().

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

Örnek: Konsol Örnek Uygulaması. Proje: 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ğunuz 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 tanıyan GUID biçimli customerTenantId değeridir.
tür string Y Alınacak 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 ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla 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 durumlar: Bilinmiyor, Önizleme Altında, İzin Verildi, İzin Verilmiyor, Hazır Değil
En Son Güncelleştirme Zamanı string UTC'de 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"
}

İzin Verilmedi 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 birine sahip olduğunda müşterinin işlemleri engellenir:

  • UnderReview
  • Notallowed
  • Bilinmiyor

Müşterinin işlemleri aşağıdaki koşullara uygun olduğunda engellenmez:

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