Ügyfél hozzájárulásának lekérése Vezérlőpult-szállítóként
Vezérlőpult-gyártóként (CPV) REST API-k használatával megkaphatja és visszavonhatja CSP-ügyfelei hozzájárulását, így engedélyeket szerezhet azok bérlőibe.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Jegyzet
A sebességkorlát másodpercenként 50 kérelem (RPS) minden applicationId -hez (A CPV-partner alkalmazásazonosítója).
Hozzájárulás beszerzése
URI-paraméterek
| Név | In | Szükséges | Típus | Leírás |
|---|---|---|---|---|
| ügyfél_azonosító | ösvény | Igaz | húr | A Partnerközpontban létrehozott ügyfél azonosítója |
Kérelem fejléce
Médiatípusok: application/json
| Név | Szükséges | Típus | Leírás |
|---|---|---|---|
| Felhatalmazás | Igaz | karakterlánc | Hozzáférési token a közönség https://api.partnercenter.microsoft.com számára |
| Elfogad | Igaz | karakterlánc | Elfogadható tartalomtípus; széles körben elfogadott típusalkalmazás/json |
| ms-correlationid | húr / karakterlánc | A kérések belső nyomon követésére szolgál. Ha nincs megadva ms-korrelid, a kiszolgáló minden kéréshez létrehoz egy újat | |
| ms-requestid | húr | A kérések idempotenciájához használatos. Ha nincs megadva ms-requestid, a kiszolgáló minden kéréshez létrehoz egy újat |
Kérelemtörzs
Médiatípusok: application/json
| Név | Típus | Leírás |
|---|---|---|
| applicationId | húr | A CPV-partner alkalmazásazonosítója |
| alkalmazási támogatások | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Az alkalmazástámogatások listája az ügyfelek bérlői hozzáférésének lekéréséhez |
Válaszok
| Név | Típus | Leírás |
|---|---|---|
| 200 OK | A kérés sikeres volt. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 201 Létrehozva | Az alkalmazás hozzájárulása elkészült. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 400 Hibás kérelem | Hiányzó vagy érvénytelen bemenet volt. A válasz törzse tartalmazza a hiba részleteit. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 401 Jogosulatlan | A kérés nem lett hitelesítve. Az ügyfélnek érvényes hozzáférési jogkivonatot kell átadnia az érvényes célközönség számára. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 403 Tiltott hiba | A kérés hitelesítése megtörtént, de a rendszer elutasította, mert a hívónak nincs jogosultsága a meghívás végrehajtására. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 404 Nem található | Az erőforrás nem található vagy nem érhető el a megadott bemeneti paraméterekkel. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 500 belső kiszolgálóhiba | A partner API-szolgáltatás vagy annak egyik függősége nem tudta teljesíteni a kérést. A hívók újra megpróbálhatják a kérést. Médiatípusok: application/json, application/xml, text/xml, text/json |
Meghatározások
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Név | Típus | Leírás |
|---|---|---|
| vállalatiAlkalmazásAzonosító | húr | A hozzáférést kapó erőforrás GUID-reprezentációja |
| kiterjedés | húr | A hozzáférés megszerzéséhez szükséges hatókör értékei vesszővel elválasztva |
Hozzájárulás eltávolítása
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Jegyzet
A sebességkorlát másodpercenként 50 kérelem (RPS) minden applicationId -hez (A CPV-partner alkalmazásazonosítója).
URI-paraméterek
| Név | ben | Szükséges | Típus | Leírás |
|---|---|---|---|---|
| ügyfél_azonosító | ösvény | Igaz | húr | A Partnerközpontban létrehozott ügyfél azonosítója |
| alkalmazás_azonosító | ösvény | Igaz | húr | A CPV-alkalmazás azonosítója |
Kérelem fejléce
Médiatípusok: application/json
| Név | Szükséges | Típus | Leírás |
|---|---|---|---|
| Felhatalmazás | Igaz | zsinór | Hozzáférési token a közönség https://api.partnercenter.microsoft.com számára |
| Elfogad | Igaz | húr | Elfogadható tartalomtípus, általában az alkalmazás/json típus |
| ms-correlationid | húr | A kérések belső nyomon követésére szolgál. Ha nincs megadva ms-correlationid, a kiszolgáló minden kéréshez létrehoz egy újat |
|
| ms-requestid | karakterlánc | A kérések idempotenciájához használatos. Ha nincs megadva ms-requestid, a kiszolgáló minden kéréshez létrehoz egy újat |
Válaszok
| Név | Típus | Leírás |
|---|---|---|
| 200 OK | A kérés sikeres volt. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 201 Létrehozva | Az alkalmazás beleegyezése törlődik. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 400 Hibás kérés | Hiányzó vagy érvénytelen bemenet volt. A válasz törzse tartalmazza a hiba részleteit. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 401 Jogosulatlan | A kérés nem lett hitelesítve. Az ügyfélnek érvényes hozzáférési jogkivonatot kell átadnia az érvényes célközönség számára. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 403 Tiltott | A kérés hitelesítése megtörtént, de a rendszer elutasította, mert a hívónak nincs jogosultsága a meghívás végrehajtására. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 404 Nem található | Az erőforrás nem található vagy nem érhető el a megadott bemeneti paraméterekkel. Médiatípusok: application/json, application/xml, text/xml, text/json |
|
| 500 belső kiszolgálóhiba | A partner API-szolgáltatás vagy annak egyik függősége nem tudta teljesíteni a kérést. A hívók újra megpróbálhatják a kérést. Médiatípusok: application/json, application/xml, text/xml, text/json |