Weryfikowanie identyfikatora PartnerID partnera za pośrednictwem języka C# lub interfejsu API REST Centrum partnerskiego

Artykuł
03/29/2024

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 identyfikator PartnerID, żądając profilu microsoft AI Cloud Partner Program partnera z Centrum partnerskiego. Identyfikator jest uznawany za prawidłowy, jeśli żądanie zakończy się pomyślnie.

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie 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 podpisanego partnera.

C#

Aby sprawdzić identyfikator PartnerID partnera, najpierw pobierz interfejs do operacji zbierania profilów partnerów z właściwości IAggregatePartner.Profiles. Następnie pobierz interfejs do operacji profilu programu Microsoft AI Cloud Partner Program 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 pominięto identyfikator PartnerID z wywołania Get lub GetAsync, żądanie próbuje pobrać profil programu Microsoft AI Cloud Partner Program zalogowanego partnera.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

Przykład: aplikacja testowa konsoli. Projekt: Klasa przykładów zestawu SDK Centrum partnerskiego: 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.

Imię i nazwisko/nazwa	Pisz	Wymagani	opis
mpn-id	int	Nie.	PartnerID, który identyfikuje partnera.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak.

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żne

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z usługi GitHub wraz z plikiem readme zawierającym 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 powodzenia 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"
}

Udostępnij za pośrednictwem