透過 C# 或合作夥伴中心 REST API 確認合作夥伴合作夥伴識別碼

發行項
03/07/2025

適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心

如何驗證 PartnerID。

此處顯示的技術會藉由向合作夥伴中心要求合作夥伴Microsoft AI Cloud Partner 計劃配置檔來驗證 PartnerID。如果要求成功，則會將標識碼視為有效。

先決條件

合作夥伴中心驗證中所述的認證。此案例僅支援使用 App+User 認證進行驗證。
用於驗證的合作夥伴身份識別碼 (PartnerID)。如果您省略此值，要求會擷取已登入合作夥伴的 Microsoft AI Cloud Partner 計劃設定檔。

C#

若要驗證合作夥伴的 PartnerID，請先從 IAggregatePartner.Profiles 屬性擷取夥伴配置檔集合作業的介面。然後，從 MpnProfile 屬性取得 Microsoft AI 雲端合作夥伴計畫檔案作業介面。最後，使用 PartnerID 呼叫 Get 或 GetAsync 方法來擷取 Microsoft AI Cloud Partner Program 配置檔。如果您省略 Get 或 GetAsync 呼叫中的 PartnerID，要求會嘗試擷取已登入合作夥伴的 Microsoft AI Cloud Partner 計劃配置檔。

// 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 計劃設定檔。

名字	類型	必填	描述
mpn-id	整數 (int)	不	識別合作夥伴的 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"
}

共用方式為