Obter o consentimento do cliente como fornecedor do painel de controle
Como Fornecedor do Painel de Controlo (CPV), pode utilizar APIs REST para adquirir e remover o consentimento dos seus clientes CSP, permitindo assim aceder às permissões nos seus inquilinos.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Observação
O limite de taxa é de 50 solicitações por segundo (RPS) para cada applicationId (ID do aplicativo do parceiro CPV).
Obter consentimento
Parâmetros de URI
| Nome | Em | Necessário | Tipo | Descrição |
|---|---|---|---|---|
| ID de cliente | caminho | Verdadeiro | string | ID do cliente gerado no Partner Center |
Cabeçalho da solicitação
Tipos de mídia: application/json
| Nome | Necessário | Tipo | Descrição |
|---|---|---|---|
| Autorização | Verdadeiro | string | Token de acesso para o público https://api.partnercenter.microsoft.com |
| Aceitar | Verdadeiro | string | Tipo de conteúdo aceitável; Aplicativo de tipo amplamente aceito/JSON |
| MS-CorrelationID | string | Usado para rastrear solicitações internamente. Se um ms-correlationid não for fornecido, o servidor gerará um novo para cada solicitação | |
| MS-RequestID | string | Usado para idempotência de solicitações. Se um ms-requestid não for fornecido, o servidor gerará um novo para cada solicitação |
Corpo do pedido
Tipos de mídia: application/json
| Nome | Tipo | Descrição |
|---|---|---|
| applicationId | string | ID da aplicação do parceiro CPV |
| candidaturasSubvenções | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Lista de autorizações de aplicações para que os seus clientes obtenham acesso no seu locatário |
Respostas
| Nome | Tipo | Descrição |
|---|---|---|
| 200 OK | O pedido foi bem-sucedido. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 201 Criado | O consentimento do aplicativo é criado. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 400 Pedido Inválido | Havia entrada ausente ou inválida. O corpo da resposta contém os detalhes do erro. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 401 Não autorizado | O pedido não foi autenticado. O cliente precisa passar um token de acesso válido para um público válido. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 403 Proibido | O pedido foi autenticado, mas foi recusado porque o chamador não tem o direito de invocá-lo. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 404 Não encontrado | O recurso não é encontrado ou não está disponível com os parâmetros de entrada fornecidos. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 500 Erro interno do servidor | O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem repetir a solicitação. Tipos de mídia: application/json, application/xml, text/xml, text/json |
Definições
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Nome | Tipo | Descrição |
|---|---|---|
| enterpriseApplicationId | string | A representação GUID do recurso que ganha acesso |
| Âmbito de aplicação | string | Valores separados por vírgulas do escopo para obter acesso |
Remover consentimento
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Observação
O limite de taxa é de 50 solicitações por segundo (RPS) para cada applicationId (ID do aplicativo do parceiro CPV).
Parâmetros de URI
| Nome | Em | Necessário | Tipo | Descrição |
|---|---|---|---|---|
| identificação_cliente | caminho | Verdadeiro | string | ID do cliente gerado no Partner Center |
| ID_da_Aplicação | caminho | Verdadeiro | string | ID do seu pedido de CPV |
Cabeçalho da solicitação
Tipos de mídia: application/json
| Nome | Necessário | Tipo | Descrição |
|---|---|---|---|
| Autorização | Verdadeiro | string | Token de acesso para o público https://api.partnercenter.microsoft.com |
| Aceitar | Verdadeiro | string | Tipo de conteúdo aceitável, geralmente tipo application/json |
| MS-CorrelationID | string | Usado para rastrear solicitações internamente. Se um ms-correlationid não for fornecido, o servidor gerará um novo para cada solicitação |
|
| MS-RequestID | cadeia de caracteres | Usado para idempotência de solicitações. Se um ms-requestid não for fornecido, o servidor gerará um novo para cada solicitação |
Respostas
| Nome | Tipo | Descrição |
|---|---|---|
| 200 OK | O pedido foi bem-sucedido. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 201 Criado | O consentimento do aplicativo é excluído. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 400 Pedido Inválido | Havia entrada ausente ou inválida. O corpo da resposta contém os detalhes do erro. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 401 Não autorizado | O pedido não foi autenticado. O cliente precisa passar um token de acesso válido para um público-alvo válido. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 403 Proibido | O pedido foi autenticado, mas foi recusado porque o chamador não tem o direito de invocá-lo. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 404 Não encontrado | O recurso não é encontrado ou não está disponível com os parâmetros de entrada fornecidos. Tipos de mídia: application/json, application/xml, text/xml, text/json |
|
| 500 Erro interno do servidor | O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem repetir a solicitação. Tipos de mídia: application/json, application/xml, text/xml, text/json |