Verificar o PartnerID de um 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 para o 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 em Autenticação do Partner Center. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.
O parceiro PartnerID 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 a partir da propriedade MpnProfile. Finalmente, 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: Classe de exemplos do SDK do Partner Center: VerifyPartnerMpnId.cs

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

Parâmetro do 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	Digitar	Obrigatório	Descrição
id do MPN	INT	Não	Um PartnerID que identifica o parceiro.

Cabeçalhos de solicitação

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

Corpo da solicitação

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 Partner Center .NET foi arquivada. Você pode baixar a versão do SDK no GitHub, juntamente com um arquivo leiame que contém informações úteis.

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

Resposta REST

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

Códigos de êxito e de erro de resposta

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

Exemplo de resposta (êxito)

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

Compartilhar via