Verificar uma ID do MPN do parceiroVerify a partner MPN ID

Aplica-se aApplies To

  • Partner CenterPartner Center
  • Partner Center operado pela 21VianetPartner Center operated by 21Vianet
  • Partner Center do Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Partner Center do Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Como verificar o identificador de Microsoft Partner Network de um parceiro (ID MPN).How to verify a partner's Microsoft Partner Network identifier (MPN ID).

A técnica mostrada aqui verifica o identificador de Microsoft Partner Network do parceiro solicitando o perfil MPN do parceiro no Partner Center.The technique shown here verifies the partner's Microsoft Partner Network identifier by requesting the partner's MPN profile from partner center. O identificador será considerado válido se a solicitação tiver sucesso.The identifier is considered valid if the request succeeds.

Pré-requisitosPrerequisites

  • Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Este cenário dá suporte somente à autenticação com credenciais de aplicativo + de usuário.This scenario supports authentication with App+User credentials only.

  • A ID de MPN do parceiro a ser verificada.The partner MPN ID to verify. Se você omitir esse valor, a solicitação recuperará o perfil MPN do parceiro conectado.If you omit this value, the request retrieves the MPN profile of the signed-in partner.

C#C#

Para verificar a ID do MPN de um parceiro, primeiro recupere uma interface para operações de coleta de perfil de parceiro da propriedade IAggregatePartner. Profiles .To verify a partner's MPN ID, first retrieve an interface to partner profile collection operations from the IAggregatePartner.Profiles property. Em seguida, obtenha uma interface para as operações de perfil MPN da propriedade MpnProfile .Then get an interface to MPN profile operations from the MpnProfile property. Por fim, chame os métodos Get ou getasync com a ID MPN para recuperar o perfil MPN.Finally, call the Get or GetAsync methods with the MPN ID to retrieve the MPN profile. Se você omitir a ID MPN da chamada Get ou getasync, a solicitação tentará recuperar o perfil MPN do parceiro conectado.If you omit the MPN ID from the Get or GetAsync call, the request attempts to retrieve the MPN profile of the signed-in partner.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

Exemplo: aplicativo de teste do console.Sample: Console test app. Projeto: classede exemplos do SDK do Partner Center: VerifyPartnerMpnId.csProject: Partner Center SDK Samples Class: VerifyPartnerMpnId.cs

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET {baseURL}/v1/Profiles/MPN? mpnId = {MPN-ID} http/1.1{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

Parâmetro do URIURI parameter

Forneça o seguinte parâmetro de consulta para identificar o parceiro.Provide the following query parameter to identify the partner. Se você omitir esse parâmetro de consulta, a solicitação retornará o perfil MPN do parceiro conectado.If you omit this query parameter, the request returns the MPN profile of the signed-in partner.

NomeName TipoType ObrigatórioRequired DescriçãoDescription
id do MPNmpn-id intint NãoNo Uma ID de Microsoft Partner Network que identifica o parceiro.A Microsoft Partner Network ID that identifies the partner.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

Nenhum.None.

Exemplo de solicitaçãoRequest example

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

Resposta RESTREST response

Se for bem-sucedido, o corpo da resposta conterá o recurso MpnProfile para o parceiro.If successful, the response body contains the MpnProfile resource for the partner.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, confira Códigos de erro REST do Partner Center.For the full list, see Partner Center REST error codes.

Exemplo de resposta (êxito)Response example (success)

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

{
    "mpnId": "4391507",
    "profileType": "MpnProfile",
    "links": {
        "self": {
            "uri": "/profiles/mpn",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "MpnProfile"
    }
}

Exemplo de resposta (falha)Response example (failure)

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