Verifiera ett partner-PartnerID via C# eller REST-API:et för Partnercenter

Artikel
03/29/2024

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Så här verifierar du ett PartnerID.

Tekniken som visas här verifierar PartnerID genom att begära partnerns Microsoft AI Cloud Partner Program-profil från Partnercenter. Identifieraren anses vara giltig om begäran lyckas.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.
PartnerPartnerID som ska verifieras. Om du utelämnar det här värdet hämtar begäran Microsoft AI Cloud Partner Program-profilen för den inloggade partnern.

C#

Om du vill verifiera partnerns PartnerID hämtar du först ett gränssnitt för insamlingsåtgärder för partnerprofiler från egenskapen IAggregatePartner.Profiles. Hämta sedan ett gränssnitt till Profilåtgärder för Microsoft AI Cloud Partner Program från egenskapen MpnProfile. Anropa slutligen Get- eller GetAsync-metoderna med PartnerID för att hämta Microsoft AI Cloud Partner Program-profilen. Om du utelämnar PartnerID från Get- eller GetAsync-anropet försöker begäran hämta Microsoft AI Cloud Partner Program-profilen för den inloggade partnern.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

Exempel: Konsoltestapp. Projekt: SDK-exempelklass för Partnercenter: VerifyPartnerMpnId.cs

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

URI-parameter

Ange följande frågeparameter för att identifiera partnern. Om du utelämnar den här frågeparametern returnerar begäran Microsoft AI Cloud Partner Program-profilen för den inloggade partnern.

Namn	Type	Obligatoriskt	Beskrivning
mpn-id	heltal	Inga	Ett PartnerID som identifierar partnern.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Inga.

Exempel på begäran

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

Viktigt!

Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub tillsammans med en readme-fil som innehåller användbar information.

Partner uppmanas att fortsätta att använda REST-API:er för Partnercenter.

REST-svar

Om det lyckas innehåller svarstexten MpnProfile-resursen för partnern.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Svarsexempel (lyckades)

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

Svarsexempel (fel)

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

Dela via