Получение состояния проверки клиента

Статья
07/18/2024

Партнер может получить состояние проверки клиента по требованию.

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

Установленные учетные данные, как описано в проверке подлинности Центра партнеров. Этот сценарий поддерживает только проверку подлинности с использованием учетных данных приложений и пользователей.
Идентификатор клиента (customer-tenant-id). Если вы не знаете идентификатор клиента, его можно найти в Центре партнеров, выбрав рабочую область "Клиенты" , затем клиент из списка клиентов, а затем учетная запись. На странице "Учетная запись клиента" найдите идентификатор Майкрософт в разделе "Сведения о учетной записи клиента". Идентификатор Майкрософт совпадает с идентификатором клиента (customer-tenant-id).

C#

Чтобы получить состояние проверки клиента для своей учетной записи, сначала создайте перечисление, представляющее Тип проверки для получения. Затем вызовите метод IAggregatePartner.Customers.ById с идентификатором клиента. Затем используйте свойство ValidationStatus для получения интерфейса IValidationStatus . Наконец, вызов GetValidationStatus() или GetValidationStatusAsync() переменная перечисления типа проверки в качестве входного параметра.

var validationTypeToFetch = ValidationType.Account;
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).ValidationStatus.GetValidationStatus(validationTypeToFetch);

Пример: пример консольного приложения. Проект: класс SdkSamples: GetValidationStatus.cs

Запрос REST

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

Method	URI-адрес
GET	{baseURL}/v1/customers/{customer-id}/validationStatus?type=account

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

Используйте следующий параметр запроса, чтобы указать клиент, для который вы извлеките состояние проверки.

Имя.	Type	Обязательно	Описание
{customer-id}	guid	Y	Это значение — это идентификатор GUID, отформатированный CustomerTenantId, который позволяет указать клиента.
type	строка	Y	Тип извлекаемого состояния проверки.

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

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

Ответ REST

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

Поля ответа

Поле	Тип	Description	Основание
Тип	Перечисление	Тип сведений о проверке	Те же данные, что и тип проверки. Тип проверки возвращает учетную запись в качестве типа ответа.
Состояние	строка	Статус проверки	Доступные состояния: Unknown, UnderReview, Allowed, NotAllowed, Not Ready
Последнее время обновления	строка	время последнего обновления состояния в формате UTC	Время даты больше не заполняется и будет пустой строкой.

Примеры ответов

Разрешено состояние

{
    "type": "account",
    "status": "Allowed",
    "lastUpdateDateTime": ""
}

Состояние проверки

{
    "type": "account",
    "status": "UnderReview",
    "lastUpdateDateTime": ""
}

Состояние NotAllowed

{
    "type": "account",
    "status": "NotAllowed",
    "lastUpdateDateTime": ""
}

Состояние "Неизвестно"

{
    "type": "account",
    "status": "Unknown",
    "lastUpdateDateTime": ""
}

Состояние "Не готово"

{
    "type": "account",
    "status": "Not Ready",
    "lastUpdateDateTime": ""
}

Ошибка 404 не найдена

{
    "code": 600074,
    "message": "Account Status for the customer, {customer-id} was not found.",
    "description": "Account Status for the customer, {customer-id} was not found.",
    "errorName": "AccountStatusNotFound",
    "isRetryable": false,
    "errorMessageExtended": "InternalErrorCode=600074"

Право на покупку

Транзакции клиента блокируются, если у учетной записи есть какие-либо состояния ниже:

UnderReview
NotAllowed
Неизвестно

Транзакции клиента не блокируются при выполнении следующих условий:

У клиента есть состояние "Разрешено"
У клиента нет состояния учетной записи

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