C# veya İş Ortağı Merkezi REST API'si aracılığıyla bir iş ortağı İş Ortağı Kimliği doğrulama
Ş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"
}