Comprobar un partner PartnerID a través de C# o la API REST del Centro de partners

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

Cómo comprobar un PartnerID.

La técnica que se muestra aquí comprueba el PartnerID solicitando el perfil del Programa de partners de Microsoft AI Cloud Partner Program del Centro de partners. El identificador se considera válido si la solicitud se realiza correctamente.

Requisitos previos

• Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.

• PartnerID que se va a comprobar. Si omite este valor, la solicitud recupera el perfil de Microsoft AI Cloud Partner Program del asociado que ha iniciado sesión.

C#

Para comprobar el PartnerID de un asociado, primero recupere una interfaz para las operaciones de recopilación de perfiles de asociados de la propiedad IAggregatePartner.Profiles. A continuación, obtenga una interfaz para las operaciones de perfil del Programa de partners en la nube de Microsoft AI desde la propiedad MpnProfile. Por último, llame a los métodos Get o GetAsync con partnerID para recuperar el perfil del Programa de partners en la nube de Microsoft AI. Si omite el PartnerID de la llamada Get o GetAsync, la solicitud intenta recuperar el perfil de Microsoft AI Cloud Partner Program del asociado que inició sesión.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

Ejemplo: Aplicación de prueba de consola. Project: Clase de ejemplos del SDK del Centro de partners: VerifyPartnerMpnId.cs

Solicitud REST

Sintaxis de la solicitud

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

Parámetro de URI

Proporcione el siguiente parámetro de consulta para identificar al asociado. Si omite este parámetro de consulta, la solicitud devuelve el perfil microsoft AI Cloud Partner Program del asociado que ha iniciado sesión.

Nombre	Type	Obligatorio	Descripción
mpn-id	int	No	PartnerID que identifica al asociado.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

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

Importante

A partir de junio de 2023, la versión 3.4.0 más reciente del SDK de .NET del Centro de partners ahora está archivada. Puede descargar esta versión del SDK de GitHub, junto con un archivo Léame que contiene información útil.

Se recomienda a los partners seguir usando las API REST del Centro de partners.

Respuesta REST

Si se ejecuta correctamente, el cuerpo de la respuesta contiene el recurso MpnProfile para el asociado.

Códigos de error y de respuesta correctos

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. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

Ejemplo de respuestas (correctas)

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

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

Ejemplo de respuesta (error)

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