Udostępnij za pośrednictwem


Zweryfikuj PartnerID za pomocą C# lub REST API Centrum partnerskiego.

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Jak zweryfikować identyfikator Partnera.

Przedstawiona tutaj technika weryfikuje PartnerID, żądając profilu partnera z programu Microsoft AI Cloud Partner Program w Centrum Partnerów. Identyfikator jest uznawany za prawidłowy, jeśli żądanie zakończy się pomyślnie.

Warunki wstępne

  • Poświadczenia zgodnie z opisem w uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń aplikacji i użytkownika.

  • PartnerID partnera do zweryfikowania. Jeśli pominiesz tę wartość, żądanie pobierze profil programu Microsoft AI Cloud Partner Program zalogowanego partnera.

C#

Aby zweryfikować identyfikator PartnerID partnera, najpierw pobierz interfejs do operacji zarządzania kolekcją profili partnerów z właściwości IAggregatePartner.Profiles. Następnie uzyskaj interfejs do operacji profilu programu partnerskiego Microsoft AI Cloud z właściwości MpnProfile. Na koniec wywołaj metody Get lub GetAsync za pomocą identyfikatora PartnerID, aby pobrać profil programu Microsoft AI Cloud Partner Program. Jeśli pominiesz identyfikator PartnerID w wywołaniu Get lub GetAsync, żądanie podejmie próbę pobrania profilu programu Microsoft AI Cloud Partner Program zalogowanego partnera.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

Przykład: konsolowa aplikacja testowa. Project: Partner Center SDK Samples Class: VerifyPartnerMpnId.cs

Żądanie REST

Składnia żądania

Metoda Identyfikator URI żądania
GET {baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

Parametr identyfikatora URI

Podaj następujący parametr zapytania, aby zidentyfikować partnera. Jeśli pominiesz ten parametr zapytania, żądanie zwróci profil programu Microsoft AI Cloud Partner Program zalogowanego partnera.

Nazwa Typ Wymagane Opis
mpn-id Int Nie PartnerID, który identyfikuje partnera.

Nagłówki żądań

Aby uzyskać dodatkowe informacje, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Żaden.

Przykład żądania

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

Ważny

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z witryny GitHub, wraz z plikiem README , który zawiera przydatne informacje.

Zachęcamy partnerów do dalszego korzystania z interfejsów API REST Centrum Partnerskiego .

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera zasób MpnProfile dla partnera.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi (powodzenie)

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

Przykład odpowiedzi (niepowodzenie)

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