Klanttoestemming krijgen als Leverancier van het Configuratiescherm
Als CPV (Control Panel Vendor) kunt u REST API's gebruiken om toestemming van uw CSP-klanten te verkrijgen en te verwijderen om machtigingen in hun tenants te krijgen.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Notitie
De frequentielimiet is 50 aanvragen per seconde (RPS) voor elke applicationId (toepassings-id van de CPV-partner).
Toestemming verkrijgen
URI-parameters
| Naam | In | Vereist | Type | Beschrijving |
|---|---|---|---|---|
| customer_id | pad | Waar | snaar | ID van de klant die is gegenereerd in Partnercentrum |
Aanvraagheader
Mediatypen: application/json
| Naam | Vereist | Type | Beschrijving |
|---|---|---|---|
| Machtiging | Waar | snaar | Toegangstoken voor doelgroep-https://api.partnercenter.microsoft.com |
| Accepteren | Waar | snaar | Acceptabel inhoudstype; algemeen geaccepteerde typetoepassing/json |
| ms-correlationid | snaar | Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-correlationid wordt opgegeven, genereert de server een nieuwe voor elke aanvraag | |
| ms-requestid | tekenreeks | Wordt gebruikt voor idempotentie van verzoeken. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag |
Aanvraagtekst
Mediatypen: application/json
| Naam | Type | Beschrijving |
|---|---|---|
| applicationId | draad | Applicatie-ID van de CPV-partner |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Lijst met toepassingstoestemmingen om uw klanten toegang te geven tot hun tenant. |
Reacties
| Naam | Soort | Beschrijving |
|---|---|---|
| 200 OK | De aanvraag is voltooid. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 201 Aangemaakt | De toepassingstoestemming wordt gemaakt. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 400 Foutieve aanvraag | Er ontbreekt of ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 401 Niet geautoriseerd | De aanvraag is niet geverifieerd. De client moet een geldig toegangstoken doorgeven om de juiste doelgroep te bereiken. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 403 Verboden | De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 404 niet gevonden | De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 500 Interne serverfout | De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag. Bellers kunnen de aanvraag opnieuw proberen. Mediatypen: application/json, application/xml, text/xml, text/json |
Definities
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Naam | Type | Beschrijving |
|---|---|---|
| Enterprise-applicatie-id | koord | De GUID-weergave van de resource die toegang krijgt |
| draagwijdte | snaar | Door komma's gescheiden waarden van het bereik voor het verkrijgen van toegang |
Toestemming verwijderen
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Notitie
De frequentielimiet is 50 aanvragen per seconde (RPS) voor elke applicationId (toepassings-id van de CPV-partner).
URI-parameters
| Naam | In | Vereist | Type | Beschrijving |
|---|---|---|---|---|
| customer_id | pad | Waar | string | ID van de klant die is gegenereerd in Partnercentrum |
| Application_id | pad | Waar | tekenreeks | ID van uw CPV-applicatie |
Aanvraagheader
Mediatypen: application/json
| Naam | Vereist | Type | Beschrijving |
|---|---|---|---|
| Machtiging | Waar | snaar | Toegangstoken voor doelgroep https://api.partnercenter.microsoft.com |
| Accepteren | Waar | snaar | Acceptabel inhoudstype, meestal type toepassing/json |
| ms-correlationid | string | Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-correlationid wordt opgegeven, genereert de server een nieuwe voor elke aanvraag |
|
| ms-requestid | snaar | Wordt gebruikt voor idempotentie van aanvragen. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag |
Reacties
| Naam | Type | Beschrijving |
|---|---|---|
| 200 OK | De aanvraag is voltooid. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 201 Gemaakt | De toestemming van de toepassing wordt verwijderd. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 400 Foutieve aanvraag | Er ontbreekt of er is ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 401 Niet geautoriseerd | De aanvraag is niet geverifieerd. De klant moet een geldig toegangstoken doorgeven voor een geldige doelgroep. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 403 Verboden | De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 404 niet gevonden | De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters. Mediatypen: application/json, application/xml, text/xml, text/json |
|
| 500 Interne serverfout | De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag. Bellers kunnen de aanvraag opnieuw proberen. Mediatypen: application/json, application/xml, text/xml, text/json |