Проверка партнера PartnerID с помощью C# или REST API Центра партнеров

применимо к: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud для государственных организаций США

Как проверить Идентификатор партнера.

Приведенный здесь метод проверяет PartnerID, запрашивая профиль программы Microsoft AI Cloud Partner Program партнера из Центра партнеров. Идентификатор считается допустимым, если запрос выполнен успешно.

Необходимые условия

• Учетные данные, как описано в авторизации в Центре партнеров. Этот сценарий поддерживает проверку подлинности только с учетными данными app+User.

• PartnerID для проверки. Если это значение не указано, запрос извлекает профиль Microsoft AI Cloud Partner Program партнера, вошедшего в систему.

C#

Чтобы проверить идентификатор партнера, сначала получите интерфейс для операций сбора профилей партнеров из свойства IAggregatePartner.Profiles. Затем получите интерфейс для работы с профилем в Microsoft AI Cloud Partner Program из свойства MpnProfile. Наконец, вызовите методы Get или GetAsync с помощью PartnerID, чтобы извлечь профиль программы Microsoft AI Cloud Partner Program. Если вы опустите PartnerID из вызова Get или GetAsync, запрос пытается получить профиль программы Microsoft AI Cloud Partner Program для вошедшего в систему партнера.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

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

пример: консольное тестовое приложение. Проект: Примеры SDK для Центра партнеров Класс: VerifyPartnerMpnId.cs

REST-запрос

Синтаксис запроса

Метод	URI запроса
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

Параметр URI

Укажите следующий параметр запроса для идентификации партнера. Если этот параметр запроса не указан, запрос возвращает профиль Microsoft AI Cloud Partner Program для вошедшего партнера.

Имя	Тип	Обязательно	Описание
mpn-id	int	Нет	Идентификатор партнера, идентифицирующий партнера.

Заголовки запросов

Дополнительные сведения см. в заголовках REST Центра партнеров .

Текст запроса

Никто.

Пример запроса

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

Важный

По состоянию на июнь 2023 г. последняя версия пакета SDK для .NET для Центра партнеров 3.4.0 теперь архивируется. Вы можете скачать выпуск SDK с GitHubвместе с файлом Readme, содержащим полезную информацию.

Партнерам рекомендуется продолжать использовать REST API центра партнеров .

ответ REST

В случае успешного выполнения текст ответа содержит ресурс MpnProfile для партнера.

Коды успешных и ошибочных ответов

Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Полный список см. в разделе Коды ошибок REST Центра партнеров.

Пример ответа (успешно)

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

Пример ответа (сбой)

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