Получение согласия клиента в качестве поставщика панель управления
В качестве поставщика панель управления (CPV) можно использовать REST API для получения и удаления согласия от клиентов CSP для получения разрешений в своих клиентах.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Примечание.
Ограничение скорости составляет 50 запросов в секунду (RPS) для каждого приложения (идентификатор приложения партнера CPV).
Получение согласия
Параметры универсального кода ресурса (URI)
| Имя. | In | Обязательное поле | Type | Описание |
|---|---|---|---|---|
| customer_id | path | Истина | строка | Идентификатор клиента, созданного в Центре партнеров |
Заголовок запроса
Типы носителей: application/json
| имени | Обязательно | Type | Описание |
|---|---|---|---|
| Авторизация | Истина | строка | Маркер доступа для аудитории https://api.partnercenter.microsoft.com |
| Accept | Истина | строка | Допустимый тип контента; широко принятое приложение типа или json |
| ms-correlationid | строка | Используется для отслеживания запросов внутри системы. Если ms-correlationid не указан, сервер создает новый для каждого запроса. | |
| ms-requestid | строка | Используется для идемпотентности запросов. Если ms-requestid не указан, сервер создает новый для каждого запроса. |
Текст запроса
Типы носителей: application/json
| Имя. | Тип | Описание |
|---|---|---|
| applicationId | строка | Идентификатор приложения партнера CPV |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Список грантов приложений для получения доступа для клиентов в клиенте |
Отклики
| Имя. | Тип | Описание |
|---|---|---|
| 200 OK | Запрос выполнен успешно. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 201 Создано | Создается согласие приложения. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 400 — недопустимый запрос | Отсутствуют или недопустимые входные данные. Текст ответа содержит сведения об ошибке. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 401 — не авторизовано | Запрос не прошел проверку подлинности. Клиент должен передать допустимый маркер доступа для допустимой аудитории. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 403. Запрещено | Запрос прошел проверку подлинности, но был отклонен, так как вызывающий объект не имеет прав на его вызов. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 404 Не найдено | Ресурс не найден или недоступен с заданными входными параметрами. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 500 Internal Server Error (внутренняя ошибка сервера). | Служба API партнера или одна из зависимостей не выполнила запрос. Вызывающие могут повторить запрос. Типы носителей: application/json, , application/xmltext/xmltext/json |
Определения
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Имя. | Тип | Описание |
|---|---|---|
| enterpriseApplicationId | строка | Представление GUID ресурса, получающего доступ |
| область | строка | Разделенные запятыми значения области для получения доступа |
Удаление согласия
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Примечание.
Ограничение скорости составляет 50 запросов в секунду (RPS) для каждого приложения (идентификатор приложения партнера CPV).
Параметры универсального кода ресурса (URI)
| Имя. | In | Обязательное поле | Type | Описание |
|---|---|---|---|---|
| customer_id | path | Истина | строка | Идентификатор клиента, созданного в Центре партнеров |
| Application_id | path | Истина | строка | Идентификатор приложения CPV |
Заголовок запроса
Типы носителей: application/json
| имени | Обязательно | Type | Описание |
|---|---|---|---|
| Авторизация | Истина | строка | Маркер доступа для аудитории https://api.partnercenter.microsoft.com |
| Accept | Истина | строка | Допустимый тип контента, обычно тип application/json |
| ms-correlationid | строка | Используется для отслеживания запросов внутри системы. ms-correlationid Если не предоставлено, сервер создает новый для каждого запроса. |
|
| ms-requestid | строка | Используется для идемпотентности запросов. Если ms-requestid не указан, сервер создает новый для каждого запроса. |
Отклики
| Имя. | Тип | Описание |
|---|---|---|
| 200 OK | Запрос выполнен успешно. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 201 Создано | Согласие приложения удаляется. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 400 — недопустимый запрос | Отсутствуют или недопустимые входные данные. Текст ответа содержит сведения об ошибке. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 401 — не авторизовано | Запрос не прошел проверку подлинности. Клиент должен передать допустимый маркер доступа для допустимой аудитории. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 403. Запрещено | Запрос прошел проверку подлинности, но был отклонен, так как вызывающий объект не имеет прав на его вызов. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 404 Не найдено | Ресурс не найден или недоступен с заданными входными параметрами. Типы носителей: application/json, , application/xmltext/xmltext/json |
|
| 500 Internal Server Error (внутренняя ошибка сервера). | Служба API партнера или одна из зависимостей не выполнила запрос. Вызывающие могут повторить запрос. Типы носителей: application/json, , application/xmltext/xmltext/json |