Müşterinin doğrulama durumunu alma

Makale
03/08/2023

İş 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

Aracılığıyla paylaş