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

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

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

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

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

C#

Чтобы получить состояние проверки учетной записи клиента, сначала создайте перечисление, представляющее ValidationType, которое необходимо получить. Затем вызовите метод 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

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

Метод	УРИ
ПОЛУЧИТЬ	{baseURL}/v1/customers/{customer-id}/validationStatus?type=аккаунт

Параметр URI

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

Имя	Тип	Обязательно	Описание
{идентификатор клиента}	гид	У	Это значение — идентификатор CustomerTenantId в формате GUID, который позволяет указать клиента.
тип	струна	У	Тип извлекаемого статуса проверки.

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

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

Ответ на запрос REST

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

Поля ответа

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

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

Разрешённый статус

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

На проверке

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

Состояние Запрещено

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

Условия для покупки

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

• На рассмотрении
• Не разрешено
• Неизвестный

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

• У клиента есть состояние "Разрешено"
• У клиента нет статуса учетной записи
• Клиент — это пользователь песочницы