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