Få kundmedgivande som Kontrolna tabla leverantör
Som Kontrolna tabla leverantö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
Kommentar
Hastighetsgränsen är 50 begäranden per sekund (RPS) för varje applicationId (program-ID för CPV-partnern).
Skaffa medgivande
URI-parametrar
| Name | I | Obligatoriskt | Type | Beskrivning |
|---|---|---|---|---|
| customer_id | path | Sant | sträng | ID för kunden som genererats i Partnercenter |
Begärandehuvud
Medietyper: application/json
| Namn | Obligatoriskt | Type | Beskrivning |
|---|---|---|---|
| Auktorisering | Sant | sträng | Åtkomsttoken för målgrupp https://api.partnercenter.microsoft.com |
| Acceptera | Sant | 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 idempotens för begäranden. Om ett ms-requestid inte har angetts genererar servern en ny för varje begäran |
Begärandetext
Medietyper: application/json
| Namn | Type | Beskrivning |
|---|---|---|
| applicationId | sträng | Program-ID för CPV-partnern |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Lista över programbidrag för att få åtkomst för dina kunder i deras klientorganisation |
Svar
| Namn | Type | Beskrivning |
|---|---|---|
| 200 OK | Begäran lyckades. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 201 Skapad | Programmets medgivande skapas. 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 behörig | Begäran autentiserades inte. Klienten måste skicka en giltig åtkomsttoken för en giltig målgrupp. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 403 – Förbjuden | 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 | Type | Beskrivning |
|---|---|---|
| enterpriseApplicationId | sträng | GUID-representationen av resursen som får åtkomst |
| omfattning | sträng | Kommaavgränsade värden för omfånget för att få åtkomst |
Ta bort medgivande
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Kommentar
Hastighetsgränsen är 50 begäranden per sekund (RPS) för varje applicationId (program-ID för CPV-partnern).
URI-parametrar
| Name | I | Obligatoriskt | Type | Beskrivning |
|---|---|---|---|---|
| customer_id | path | Sant | sträng | ID för kunden som genererats i Partnercenter |
| Application_id | path | Sant | sträng | ID för ditt CPV-program |
Begärandehuvud
Medietyper: application/json
| Namn | Obligatoriskt | Type | Beskrivning |
|---|---|---|---|
| Auktorisering | Sant | sträng | Åtkomsttoken för målgrupp https://api.partnercenter.microsoft.com |
| Acceptera | Sant | 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 idempotens för begäranden. Om ett ms-requestid inte har angetts genererar servern en ny för varje begäran |
Svar
| Namn | Type | Beskrivning |
|---|---|---|
| 200 OK | Begäran lyckades. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 201 Skapad | Programmets medgivande tas bort. 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 behörig | Begäran autentiserades inte. Klienten måste skicka en giltig åtkomsttoken för en giltig målgrupp. Medietyper: application/json, application/xml, text/xml, text/json |
|
| 403 – Förbjuden | 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 |