Comprobar un id. de MPN de asociadoVerify a partner MPN ID

Se aplica aApplies To

  • Centro de partnersPartner Center
  • Centro de partners operado por 21VianetPartner Center operated by 21Vianet
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Cómo comprobar el identificador de Microsoft Partner Network de un asociado (identificador de MPN).How to verify a partner's Microsoft Partner Network identifier (MPN ID).

La técnica que se muestra aquí comprueba el identificador del Microsoft Partner Network del asociado solicitando el perfil MPN del asociado del centro de Partners.The technique shown here verifies the partner's Microsoft Partner Network identifier by requesting the partner's MPN profile from partner center. El identificador se considera válido si la solicitud se realiza correctamente.The identifier is considered valid if the request succeeds.

Requisitos previosPrerequisites

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners.Credentials as described in Partner Center authentication. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.This scenario supports authentication with App+User credentials only.

  • IDENTIFICADOR de MPN del asociado que se va a comprobar.The partner MPN ID to verify. Si se omite este valor, la solicitud recupera el perfil MPN del asociado que tiene la sesión iniciada.If you omit this value, the request retrieves the MPN profile of the signed-in partner.

C#C#

Para comprobar el identificador de MPN de un asociado, primero recupere una interfaz para las operaciones de colección de Perfil de socio comercial de la propiedad [colección iaggregatepartner. profiles/dotnet/API/Microsoft.Store.partnercenter.ipartner.profiles).To verify a partner's MPN ID, first retrieve an interface to partner profile collection operations from the [IAggregatePartner.Profiles/dotnet/api/microsoft.store.partnercenter.ipartner.profiles) property. A continuación, obtenga una interfaz para las operaciones de Perfil de MPN desde la propiedad [MpnProfile/dotnet/API/Microsoft.Store.partnercenter.profiles.ipartnerprofilecollection.mpnprofile).Then get an interface to MPN profile operations from the [MpnProfile/dotnet/api/microsoft.store.partnercenter.profiles.ipartnerprofilecollection.mpnprofile) property. Por último, llame a los métodos [Get/dotnet/API/Microsoft.Store.partnercenter.profiles.impnprofile.Get) o [GetAsync/DOTNET/API/Microsoft.Store.PARTNERCENTER.profiles.IMPNPROFILE.GETASYNC) con el identificador de MPN para recuperar el perfil de MPN.Finally, call the [Get/dotnet/api/microsoft.store.partnercenter.profiles.impnprofile.get) or [GetAsync/dotnet/api/microsoft.store.partnercenter.profiles.impnprofile.getasync) methods with the MPN ID to retrieve the MPN profile. Si omite el ID. de MPN de la llamada get o GetAsync, la solicitud intenta recuperar el perfil MPN del asociado que ha iniciado sesión.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);

Ejemplo: aplicación de prueba de consola.Sample: Console test app. Proyecto: SDK del centro de Partners ( clase): VerifyPartnerMpnId.CSProject: Partner Center SDK Samples Class: VerifyPartnerMpnId.cs

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/profiles/MPN? mpnId = {MPN-ID} http/1.1{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

Parámetro de URIURI parameter

Proporcione el siguiente parámetro de consulta para identificar al asociado.Provide the following query parameter to identify the partner. Si omite este parámetro de consulta, la solicitud devuelve el perfil MPN del asociado con sesión iniciada.If you omit this query parameter, the request returns the MPN profile of the signed-in partner.

NombreName TipoType ObligatorioRequired DescripciónDescription
mpn-idmpn-id intint NoNo IDENTIFICADOR de Microsoft Partner Network que identifica al asociado.A Microsoft Partner Network ID that identifies the partner.

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplo de solicitudRequest 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

Respuesta RESTREST response

Si se realiza correctamente, el cuerpo de la respuesta contiene el recurso MpnProfile para el socio comercial.If successful, the response body contains the MpnProfile resource for the partner.

Códigos de error y de respuesta correctosResponse success and error codes

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.For the full list, see Partner Center REST error codes.

Ejemplo de respuestas (correctas)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"
    }
}

Ejemplo de respuesta (error)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"
}