通过 C# 或合作伙伴中心 REST API 验证合作伙伴 ID

适用于:合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心

如何验证 PartnerID。

此处所示的技术通过从合作伙伴中心请求合作伙伴的 Microsoft AI 云合作伙伴计划配置文件来验证 PartnerID。 如果请求成功,则标识符被视为有效。

先决条件

  • 合作伙伴中心身份验证中所述的凭据。 此方案只支持使用应用凭据和用户凭据进行身份验证。

  • 要验证的合作伙伴 PartnerID。 如果省略此值,请求将检索已登录合作伙伴的 Microsoft AI 云合作伙伴计划配置文件。

C#

若要验证合作伙伴的 PartnerID,请先从 IAggregatePartner.Profiles 属性中检索合作伙伴配置文件收集操作的接口。 然后从 MpnProfile 属性获取 Microsoft AI 云合作伙伴计划配置文件操作的接口。 最后,使用 PartnerID 调用 GetGetAsync 方法以检索 Microsoft AI 云合作伙伴计划配置文件。 如果从 Get 或 GetAsync 调用中省略 PartnerID,则请求将尝试检索已登录合作伙伴的 Microsoft AI 云合作伙伴计划配置文件。

// 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 云合作伙伴计划配置文件。

名称 Type 需要 说明
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: e937630b-8341-4d70-8f73-450d32ee0189
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: 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"
    }
}

响应示例(失败)

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