Partilhar via


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).

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