Delen via


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

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.

Voorwaarden

  • Toegangsgegevens zoals beschreven in Partnercentrum-authenticatie. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.

  • De partner-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 dan vanuit de eigenschap MpnProfile een interface op voor profielbewerkingen van het Microsoft AI Cloud Partner Program. Roep tot slot 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 van: Console-test-app. Project-: Voorbeelden van partnercentrum-SDK's klasse: 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 Int Nee Een PartnerID die de partner identificeert.

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Verzoeklichaam

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 met nuttige informatie.

Partners worden aangemoedigd om de Partner center REST API'ste blijven gebruiken.

REST-antwoord

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

Geslaagde antwoorden en foutcodes

Elke respons wordt geleverd met een HTTP-statuscode die succes of mislukking aangeeft, en aanvullende informatie voor debugging. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partnercentrum REST-foutcodesvoor 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"
}