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 |