C# veya İş Ortağı Merkezi REST API'si aracılığıyla bir iş ortağı İş Ortağı Kimliği doğrulama

  • Makale

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

İş Ortağı Kimliği doğrulama.

Burada gösterilen teknik, İş Ortağı Merkezi'nden iş ortağının Microsoft AI Bulut İş Ortağı Programı profilini isteyerek İş Ortağı Kimliğini doğrular. İstek başarılı olursa tanımlayıcı geçerli kabul edilir.

Önkoşullar

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

  • Doğrulanması gereken iş ortağı İş Ortağı Kimliği. Bu değeri atlarsanız, istek oturum açmış iş ortağının Microsoft AI Bulut İş Ortağı Programı profilini alır.

C#

bir iş ortağının İş Ortağı Kimliğini doğrulamak için önce IAggregatePartner.Profiles özelliğinden iş ortağı profili toplama işlemlerine yönelik bir arabirim alın. Ardından MpnProfile özelliğinden Microsoft AI Bulut İş Ortağı Programı profil işlemlerine yönelik bir arabirim alın. Son olarak, Microsoft AI Bulut İş Ortağı Programı profilini almak için İş Ortağı Kimliği ile Get veya GetAsync yöntemlerini çağırın. Get veya GetAsync çağrısından İş Ortağı Kimliği'ni atlarsanız, istek oturum açmış iş ortağının Microsoft AI Bulut İş Ortağı Programı profilini almaya çalışır.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

var partnerProfile = partnerOperations.Profiles.MpnProfile.Get(partnerMpnId);

Örnek: Konsol test uygulaması. Proje: İş Ortağı Merkezi SDK Örnekleri Sınıfı: VerifyPartnerMpnId.cs

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
GET {baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

URI parametresi

İş ortağını tanımlamak için aşağıdaki sorgu parametresini sağlayın. Bu sorgu parametresini atlarsanız istek, oturum açmış iş ortağının Microsoft AI Bulut İş Ortağı Programı profilini döndürür.

Adı Tür Gerekli Description
mpn-id int No. İş ortağını tanımlayan bir İş Ortağı Kimliği.

İstek üst bilgileri

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

Request body

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/profiles/mpn?mpnId=9999999 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 560df6b9-6e53-4954-aed7-133477ac1194
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

REST yanıtı

Başarılı olursa, yanıt gövdesi iş ortağının MpnProfile kaynağını içerir.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten 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 örneği (başarılı)

HTTP/1.1 200 OK
Content-Length: 159
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: e39e0ddf-3fd0-4b7e-bb4e-8aebe242d3ee
MS-CV: s2GvkNgZsUSadxQX.0
MS-ServerId: 030011719
Date: Thu, 13 Apr 2017 18:13:40 GMT

{
    "partnerName": "Microsoft Partner", 
    "mpnId": "4391507",
    "profileType": "MpnProfile",
    "links": {
        "self": {
            "uri": "/profiles/mpn",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "MpnProfile"
    }
}

Yanıt örneği (hata)

HTTP/1.1 404 Not Found
Content-Length: 124
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: 560df6b9-6e53-4954-aed7-133477ac1194
MS-CV: sLRFZMWm+EKuL47u.0
MS-ServerId: 102030524
Date: Thu, 13 Apr 2017 18:26:51 GMT

{
    "code": 3000,
    "description": "Partner Organization with partner_id 9999999 could not be found",
    "data": [],
    "source": "PartnerFD"
}