Ověření PARTNERSKÉho ID partnera prostřednictvím C# nebo rozhraní REST API Partnerského centra

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Jak ověřit ID partnera

Postup uvedený zde ověří ID partnera tím, že si vyžádá profil partnerského programu Microsoft AI Cloud Partner Program z Partnerského centra. Identifikátor je považován za platný, pokud požadavek proběhne úspěšně.

Požadavky

• Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.

• Partner PartnerID, který chcete ověřit. Pokud tuto hodnotu vynecháte, požadavek načte profil programu Microsoft AI Cloud Partner Program přihlášeného partnera.

C#

Pokud chcete ověřit ID partnera, nejprve načtěte rozhraní pro operace shromažďování profilů partnerů z vlastnosti IAggregatePartner.Profiles. Potom z vlastnosti MpnProfile získejte rozhraní pro operace profilu programu Microsoft AI Cloud Partner Program. Nakonec volejte metody Get nebo GetAsync s ID partnera, aby se načetl profil programu Microsoft AI Cloud Partner Program. Pokud z volání Get nebo GetAsync vynecháte ID partnera, pokusí se žádost načíst profil programu Microsoft AI Cloud Partner Program přihlášeného partnera.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

Ukázka: Konzolová testovací aplikace Projekt: Ukázky sady SDK Partnerského centra – třída: VerifyPartnerMpnId.cs

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

Parametr identifikátoru URI

Zadejte následující parametr dotazu pro identifikaci partnera. Pokud tento parametr dotazu vynecháte, požadavek vrátí profil programu Microsoft AI Cloud Partner Program přihlášeného partnera.

Jméno	Typ	Požaduje se	Popis
mpn-id	int	Číslo	PARTNERID, který identifikuje partnera.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Žádné

Příklad požadavku

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: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Důležité

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

Odpověď REST

V případě úspěchu obsahuje text odpovědi prostředek MpnProfile partnera.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi (úspěch)

HTTP/1.1 200 OK
Content-Length: 159
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
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"
    }
}

Příklad odpovědi (selhání)

HTTP/1.1 404 Not Found
Content-Length: 124
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
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"
}