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

项目
03/29/2024

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

如何验证 PartnerID。

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

先决条件

合作伙伴中心身份验证中所述的凭据。此方案只支持使用应用凭据和用户凭据进行身份验证。
要验证的合作伙伴 PartnerID。如果省略此值，请求将检索已登录合作伙伴的 Microsoft AI 云合作伙伴计划配置文件。

C#

若要验证合作伙伴的 PartnerID，请先从 IAggregatePartner.Profiles 属性中检索合作伙伴配置文件收集操作的接口。然后从 MpnProfile 属性获取 Microsoft AI 云合作伙伴计划配置文件操作的接口。最后，使用 PartnerID 调用 Get 或 GetAsync 方法以检索 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: 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"
}

通过