Vérifier un PartnerID partenaire via C# ou l’API REST de l’Espace partenaires

Article
10/13/2023

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Comment vérifier un PartnerID.

La technique présentée ici vérifie l’ID de partenaire en demandant le profil du programme Microsoft AI Cloud Partner du partenaire à partir de l’Espace partenaires. L’identificateur est considéré comme valide si la requête réussit.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.
PartnerID partenaire à vérifier. Si vous omettez cette valeur, la demande récupère le profil du programme Microsoft AI Cloud Partner du partenaire connecté.

C#

Pour vérifier l’ID partenaire d’un partenaire, commencez par récupérer une interface pour les opérations de collecte de profils partenaires à partir de la propriété IAggregatePartner.Profiles. Obtenez ensuite une interface pour les opérations de profil du programme Microsoft AI Cloud Partner à partir de la propriété MpnProfile. Enfin, appelez les méthodes Get ou GetAsync avec PartnerID pour récupérer le profil du programme Microsoft AI Cloud Partner. Si vous omettez l’ID partenaire de l’appel Get ou GetAsync, la demande tente de récupérer le profil du programme Partenaire Cloud Microsoft AI du partenaire connecté.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

Exemple : Application de test de console. Projet : Classe d’exemples sdk de l’Espace partenaires : VerifyPartnerMpnId.cs

Demande REST

Syntaxe de la requête

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

Paramètre d’URI

Fournissez le paramètre de requête suivant pour identifier le partenaire. Si vous omettez ce paramètre de requête, la requête retourne le profil du programme Microsoft AI Cloud Partner du partenaire connecté.

Nom	Type	Requise	Description
mpn-id	int	Non	Id de partenaire qui identifie le partenaire.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Aucune.

Exemple de requête

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

Important

Depuis juin 2023, la dernière version du Kit de développement logiciel (SDK) .NET de l’Espace partenaires version 3.4.0 est désormais archivée. Vous pouvez télécharger la version du SDK à partir de GitHub, ainsi qu’un fichier lisezmoi contenant des informations utiles.

Les partenaires sont encouragés à continuer à utiliser les API REST de l’Espace partenaires.

Réponse REST

Si elle réussit, le corps de la réponse contient la ressource MpnProfile pour le partenaire.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse (réussite)

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

Exemple de réponse (échec)

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

Partager via