共用方式為


透過 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"
}