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

Articolo
03/29/2024

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 descritte in Autenticazione del Centro per i partner. 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, chiamare i metodi Get o GetAsync con 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);

Esempio: App di test della console. Progetto: Classe di esempi dell'SDK del Centro per i partner: VerifyPartnerMpnId.cs

Richiesta REST

Sintassi della richiesta

Method	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	Digita	Richiesto	Descrizione
mpn-id	int	No	PartnerID che identifica il partner.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

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 di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

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

Condividi tramite