Verificar um PartnerID de parceiro via C# ou a API REST do Partner Center

Artigo
03/29/2024

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government

Como verificar um PartnerID.

A técnica mostrada aqui verifica o PartnerID solicitando o perfil do Microsoft AI Cloud Partner Program do parceiro ao Partner Center. O identificador é considerado válido se a solicitação for bem-sucedida.

Pré-requisitos

Credenciais conforme descrito na autenticação do Partner Center. Este cenário suporta autenticação apenas com credenciais App+User.
O PartnerID do parceiro para verificar. Se você omitir esse valor, a solicitação recuperará o perfil do Microsoft AI Cloud Partner Program do parceiro conectado.

C#

Para verificar o PartnerID de um parceiro, primeiro recupere uma interface para operações de coleta de perfil de parceiro da propriedade IAggregatePartner.Profiles. Em seguida, obtenha uma interface para as operações de perfil do Microsoft AI Cloud Partner Program na propriedade MpnProfile. Por fim, chame os métodos Get ou GetAsync com o PartnerID para recuperar o perfil do Microsoft AI Cloud Partner Program. Se você omitir o PartnerID da chamada Get ou GetAsync, a solicitação tentará recuperar o perfil do Microsoft AI Cloud Partner Program do parceiro conectado.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

var partnerProfile = partnerOperations.Profiles.MpnProfile.Get(partnerMpnId);

Exemplo: Aplicativo de teste de console. Projeto: Exemplo de SDK do Partner Center Classe: VerifyPartnerMpnId.cs

Pedido REST

Sintaxe da solicitação

Método	URI do pedido
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

Parâmetro URI

Forneça o seguinte parâmetro de consulta para identificar o parceiro. Se você omitir esse parâmetro de consulta, a solicitação retornará o perfil do Microsoft AI Cloud Partner Program do parceiro conectado.

Nome	Tipo	Necessário	Descrição
ID do MPN	número inteiro	Não	Um PartnerID que identifica o parceiro.

Cabeçalhos do pedido

Para obter mais informações, consulte Cabeçalhos REST do Partner Center.

Corpo do pedido

Nenhum.

Exemplo de solicitação

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

Importante

A partir de junho de 2023, a versão 3.4.0 mais recente do SDK do .NET do Partner Center foi arquivada. Você pode baixar a versão do SDK do GitHub, juntamente com um arquivo readme que contém informações úteis.

Os parceiros são incentivados a continuar a usar as APIs REST do Partner Center.

Resposta do REST

Se bem-sucedida, o corpo da resposta contém o recurso MpnProfile para o parceiro.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplo de resposta (sucesso)

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

Exemplo de resposta (falha)

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

Partilhar via