Een partnerpartner-id verifiëren via C# of de REST API van het Partnercentrum

Artikel
03/29/2024

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Een PartnerID verifiëren.

De techniek die hier wordt weergegeven, verifieert de PartnerID door het Microsoft AI Cloud Partner Program-profiel van de partner aan te vragen vanuit het Partnercentrum. De id wordt als geldig beschouwd als de aanvraag slaagt.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
De partnerpartner-id om te verifiëren. Als u deze waarde weglaat, haalt de aanvraag het Microsoft AI Cloud Partner Program-profiel van de aangemelde partner op.

C#

Als u de Partner-id van een partner wilt controleren, haalt u eerst een interface op voor bewerkingen voor het verzamelen van partnerprofielen uit de eigenschap IAggregatePartner.Profiles. Haal vervolgens een interface op voor profielbewerkingen van het Microsoft AI Cloud Partner Program vanuit de eigenschap MpnProfile. Roep ten slotte de Get- of GetAsync-methoden aan met de PartnerID om het Microsoft AI Cloud Partner Program-profiel op te halen. Als u de PartnerID weglaat uit de aanroep Get of GetAsync, probeert de aanvraag het microsoft AI Cloud Partner Program-profiel van de aangemelde partner op te halen.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

Voorbeeld: consoletest-app. Project: Voorbeeldklasse Partner Center SDK: VerifyPartnerMpnId.cs

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

URI-parameter

Geef de volgende queryparameter op om de partner te identificeren. Als u deze queryparameter weglaat, retourneert de aanvraag het Microsoft AI Cloud Partner Program-profiel van de aangemelde partner.

Naam	Type	Vereist	Beschrijving
mpn-id	geheel getal (int)	Nee	Een PartnerID die de partner identificeert.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

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

Belangrijk

Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.

Partners worden aangemoedigd om de REST API's van partnercentrum te blijven gebruiken.

REST-antwoord

Als dit lukt, bevat de antwoordtekst de MpnProfile-resource voor de partner.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Antwoordvoorbeeld (geslaagd)

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

Antwoordvoorbeeld (fout)

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

Delen via