Få kundmedgivande som kontrollpanelsleverantör
Som kontrollpanelsleverantör (CPV) kan du använda REST-API:er för att hämta och ta bort medgivande från dina CSP-kunder för att få behörigheter till sina klienter.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Not
Hastighetsgränsen är 50 begäranden per sekund (RPS) för varje applicationId (program-ID för CPV-partnern).
Skaffa medgivande
URI-parametrar
| Namn | I | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
| kund-id | stig | Sann | sträng | ID för kunden som genererats i Partnercenter |
Begärandehuvud
Medietyper: application/json
| Namn | Krävs | Typ | Beskrivning |
|---|---|---|---|
| Tillstånd | Sann | sträng | Åtkomsttoken för målgrupp https://api.partnercenter.microsoft.com |
| Acceptera | Sann | sträng | Godkänd innehållstyp; allmänt accepterad typprogram/json |
| ms-correlationid | sträng | Används för att spåra begäranden internt. Om ett ms-correlationid inte tillhandahålls genererar servern en ny för varje begäran | |
| ms-requestid | sträng | Används för begärandens idempotens. Om ett ms-requestid inte har angetts genererar servern en ny för varje begäran |
Begärandetext
Medietyper: application/json
| Namn | Typ | Beskrivning |
|---|---|---|
| applicationId | sträng | Program-ID för CPV-partnern |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Lista över behörigheter för applikationer för att ge åtkomst för dina kunder i deras tenantmiljö |
Svaren
| Namn | Typ | Beskrivning |
|---|---|---|
| 200 OK | Begäran lyckades. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 201 Skapad | Applikationens medgivande har skapats. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 400 Felaktig begäran | Det saknades eller ogiltiga indata. Svarstexten innehåller felinformationen. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 401 Ej auktoriserad | Begäran autentiserades inte. Klienten måste ange en giltig åtkomsttoken för den avsedda målgruppen. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 403 Förbjudet | Begäran autentiserades men nekades eftersom anroparen inte har behörighet att anropa den. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 404 Hittades inte | Resursen hittas inte eller är inte tillgänglig med de angivna indataparametrarna. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 500 Internt serverfel | Partner-API-tjänsten eller något av dess beroenden kunde inte uppfylla begäran. Anropare kan försöka begäran igen. Medietyper: application/json, application/xml, text/xml, text/json |
Definitioner
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Namn | Typ | Beskrivning |
|---|---|---|
| företagsapplikations-id | sträng | GUID-representationen av resursen som får åtkomst |
| omfattning | sträng | Kommaavgränsade värden av behörighet för att få åtkomst |
Ta bort medgivande
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Not
Hastighetsgränsen är 50 begäranden per sekund (RPS) för varje applicationId (program-ID för CPV-partnern).
URI-parametrar
| Namn | I | Krävs | Typ | Beskrivning |
|---|---|---|---|---|
| kund-id | stig | Sann | sträng | ID för kunden som genererats i Partnercenter |
| Applikation_ID | stig | Sann | sträng | ID för ditt CPV-program |
Begärandehuvud
Medietyper: application/json
| Namn | Krävs | Typ | Beskrivning |
|---|---|---|---|
| Tillstånd | Sann | sträng | Åtkomsttoken för målgrupp https://api.partnercenter.microsoft.com |
| Acceptera | Sann | sträng | Acceptabel innehållstyp, skriv vanligtvis program/json |
| ms-correlationid | sträng | Används för att spåra begäranden internt. Om en ms-correlationid inte tillhandahålls genererar servern en ny för varje begäran |
|
| ms-requestid | sträng | Används för förfrågningars idempotens. Om ett ms-requestid inte har angetts genererar servern en ny för varje begäran |
Svaren
| Namn | Typ | Beskrivning |
|---|---|---|
| 200 OK | Begäran lyckades. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 201 Skapad | Applikationens medgivande har raderats. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 400 Felaktig begäran | Det saknades eller ogiltiga indata. Svarstexten innehåller felinformationen. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 401 Ej auktoriserad | Begäran autentiserades inte. Klienten måste skicka en giltig åtkomsttoken till en målgrupp som uppfyller giltighetskriterierna. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 403 Förbjudet | Begäran autentiserades men nekades eftersom anroparen inte har behörighet att anropa den. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 404 Hittades inte | Resursen hittas inte eller är inte tillgänglig med de angivna indataparametrarna. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 500 Internt serverfel | Partner-API-tjänsten eller något av dess beroenden kunde inte uppfylla begäran. Anropare kan försöka begäran igen. Medietyper: application/json, application/xml, text/xml, text/json |