Verificare un PartnerID tramite C# o l'API REST del Centro per i partner

si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Come verificare un ID partner.

La tecnica illustrata qui verifica l'ID partner richiedendo il profilo del programma Microsoft AI Cloud Partner del partner dal Centro per i partner. L'identificatore viene considerato valido se la richiesta ha esito positivo.

Prerequisiti

• Credenziali come descritto nell'autenticazione del Partner Center . Questo scenario supporta l'autenticazione solo con le credenziali app+utente.

• PartnerID da verificare. Se si omette questo valore, la richiesta recupera il profilo del programma Microsoft AI Cloud Partner del partner connesso.

C#

Per verificare l'ID partner di un partner, recuperare prima di tutto un'interfaccia per le operazioni di raccolta dei profili partner dalla proprietà IAggregatePartner.Profiles. Ottenere quindi un'interfaccia per le operazioni del profilo del programma Microsoft AI Cloud Partner dalla proprietà MpnProfile. Infine, chiamate i metodi Get o GetAsync con il PartnerID per recuperare il profilo del programma Microsoft AI Cloud Partner. Se si omette il PartnerID dalla chiamata Get o GetAsync, la richiesta tenta di recuperare il profilo del programma Microsoft AI Cloud Partner del partner connesso.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

di esempio: app di test console. Project: Esempi dell'SDK del Centro per i partner classe: VerifyPartnerMpnId.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

Parametro URI

Specificare il parametro di query seguente per identificare il partner. Se si omette questo parametro di query, la richiesta restituisce il profilo del programma Microsoft AI Cloud Partner del partner connesso.

Nome	Digitare	Obbligatorio	Descrizione
mpn-id	Int	No	PartnerID che identifica il partner.

Intestazioni della richiesta

Per ulteriori informazioni, vedere intestazioni REST di Partner Center.

Corpo della richiesta

Nessuno.

Esempio di richiesta

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

Importante

A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.

I partner sono invitati a continuare a usare le API REST del Centro per i partner .

Risposta REST

In caso di esito positivo, il corpo della risposta contiene la risorsa MpnProfile per il partner.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere il codice, il tipo di errore e i parametri aggiuntivi. Per l'elenco completo, vedere codici di errore REST del Partner Center.

Esempio di risposta (esito positivo)

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

Esempio di risposta (errore)

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