透過 C# 或合作夥伴中心 REST API 確認合作夥伴合作夥伴識別碼
適用于:合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心
如何驗證 PartnerID。
此處所示的技術會藉由向合作夥伴中心要求合作夥伴的 Microsoft AI Cloud Partner 計畫設定檔來驗證 PartnerID。 如果要求成功,則會將識別碼視為有效。
必要條件
認證,如合作夥伴中心驗證所述。 此案例僅支援使用「應用程式+使用者」認證來進行驗證。
要驗證的合作夥伴 PartnerID。 如果您省略此值,要求會擷取已登入合作夥伴的 Microsoft AI Cloud Partner 計畫設定檔。
C#
若要驗證合作夥伴的 PartnerID,請先從 IAggregatePartner.Profiles 屬性擷取夥伴設定檔集合作業的 介面。 然後從 MpnProfile 屬性取得 Microsoft AI Cloud Partner 計畫設定檔作業的 介面。 最後,使用 PartnerID 呼叫 Get 或 GetAsync 方法,以擷取 Microsoft AI Cloud Partner 計畫設定檔。 如果您省略 Get 或 GetAsync 呼叫中的 PartnerID,要求會嘗試擷取已登入合作夥伴的 Microsoft AI Cloud Partner Program 設定檔。
// IAggregatePartner partnerOperations;
// string partnerMpnId;
var partnerProfile = partnerOperations.Profiles.MpnProfile.Get(partnerMpnId);
範例 : 主控台測試應用程式 。 專案 :合作夥伴中心 SDK 範例 類別 :VerifyPartnerMpnId.cs
REST 要求
要求語法
方法 | 要求 URI |
---|---|
GET | {baseURL} /v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1 |
URI 參數
提供下列查詢參數來識別夥伴。 如果您省略此查詢參數,要求會傳回已登入合作夥伴的 Microsoft AI Cloud Partner Program 設定檔。
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
mpn-id | int | No | 識別合作夥伴的 PartnerID。 |
要求標頭
如需詳細資訊,請參閱合作夥伴中心 REST 標頭。
要求本文
無。
要求範例
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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive
重要
自 2023 年 6 月起,最新的合作夥伴中心 .NET SDK 3.4.0 版現已封存。 您可以從 GitHub 下載 SDK 版本,以及 包含實用資訊的讀我檔案 。
鼓勵合作夥伴繼續使用 合作夥伴中心 REST API 。
REST 回應
如果成功,回應本文會包含夥伴的 MpnProfile 資源。
回應成功和錯誤碼
每個回應都隨附 HTTP 狀態碼,會指出成功與否以及其他的偵錯資訊。 請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。 如需完整清單,請參閱合作夥伴中心的 REST 錯誤碼。
回應範例 (成功)
HTTP/1.1 200 OK
Content-Length: 159
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}
}
回應範例(失敗)
HTTP/1.1 404 Not Found
Content-Length: 124
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}