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

Статья
03/29/2024

Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government

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

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

Необходимые компоненты

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

C#

Чтобы проверить partnerID партнера, сначала получите интерфейс для операций сбора профилей партнеров из свойства 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

Параметр универсального кода ресурса

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

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

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

Дополнительные сведения см. в статье о заголовках 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: e937630b-8341-4d70-8f73-450d32ee0189
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 вместе с файлом чтения, содержащим полезные сведения.

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

Ответ REST

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

Коды успешного выполнения и ошибок в ответе

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

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

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

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

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

Поделиться через