Získání souhlasu zákazníka jako dodavatele Ovládací panely
Jako dodavatel Ovládací panely (CPV) můžete pomocí rozhraní REST API získat a odebrat souhlas zákazníků CSP a získat oprávnění ke svým tenantům.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Poznámka:
Limit rychlosti je 50 požadavků za sekundu (RPS) pro každé ID aplikace (ID aplikace partnera CPV).
Získání souhlasu
Parametry identifikátoru URI
| Název | V | Požaduje se | Type | Popis |
|---|---|---|---|---|
| customer_id | path | True | string | ID zákazníka vygenerovaného v Partnerském centru |
Hlavička požadavku
Typy médií: application/json
| Název | Požadováno | Type | Popis |
|---|---|---|---|
| Autorizace | True | string | Přístupový token pro cílovou skupinu https://api.partnercenter.microsoft.com |
| Přijmout | True | string | Přijatelný typ obsahu; široce přijímaný typ application/json |
| ms-correlationid | string | Používá se pro interní sledování požadavků. Pokud není zadaný parametr ms-correlationid, server pro každý požadavek vygeneruje nový. | |
| ms-requestid | string | Používá se k idempotenci požadavků. Pokud není zadaný identifikátor ms-requestid, server pro každý požadavek vygeneruje nový. |
Text požadavku
Typy médií: application/json
| Name | Typ | Popis |
|---|---|---|
| applicationId | string | ID aplikace partnera CPV |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Seznam grantů pro získání přístupu pro zákazníky ve svém tenantovi |
Odpovědi
| Name | Typ | Popis |
|---|---|---|
| 200 OK | Požadavek byl úspěšný. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 201 Vytvořeno | Vytvoří se souhlas aplikace. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 400 – Chybný požadavek | Nebyl nalezen nebo neplatný vstup. Text odpovědi obsahuje podrobnosti o chybě. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 401 – Neautorizováno | Požadavek nebyl ověřen. Klient musí předat platný přístupový token pro platnou cílovou skupinu. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 403 – Zakázáno | Žádost byla ověřena, ale byla odmítnuta, protože volající nemá práva k jejímu vyvolání. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 404 – Nenalezeno | Prostředek nebyl nalezen nebo není k dispozici s danými vstupními parametry. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 500 – Vnitřní chyba serveru | Službě partnerského rozhraní API nebo některé z jejích závislostí se nepodařilo splnit požadavek. Volající můžou žádost opakovat. Typy médií: application/json, application/xml, text/xmltext/json |
Definice
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Name | Typ | Popis |
|---|---|---|
| EnterpriseApplicationId | string | Reprezentace identifikátoru GUID prostředku, který získává přístup |
| rozsah | string | Čárkami oddělené hodnoty oboru pro získání přístupu |
Odebrání souhlasu
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Poznámka:
Limit rychlosti je 50 požadavků za sekundu (RPS) pro každé ID aplikace (ID aplikace partnera CPV).
Parametry identifikátoru URI
| Název | V | Požaduje se | Type | Popis |
|---|---|---|---|---|
| customer_id | path | True | string | ID zákazníka vygenerovaného v Partnerském centru |
| Application_id | path | True | string | ID vaší aplikace CPV |
Hlavička požadavku
Typy médií: application/json
| Název | Požadováno | Type | Popis |
|---|---|---|---|
| Autorizace | True | string | Přístupový token pro cílovou skupinu https://api.partnercenter.microsoft.com |
| Přijmout | True | string | Přijatelný typ obsahu, obvykle typ application/json |
| ms-correlationid | string | Používá se pro interní sledování požadavků. ms-correlationid Pokud není zadaný, server pro každou žádost vygeneruje nový. |
|
| ms-requestid | string | Používá se k idempotenci požadavků. Pokud není zadaný identifikátor ms-requestid, server pro každý požadavek vygeneruje nový. |
Odpovědi
| Name | Typ | Popis |
|---|---|---|
| 200 OK | Požadavek byl úspěšný. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 201 Vytvořeno | Souhlas aplikace se odstraní. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 400 – Chybný požadavek | Nebyl nalezen nebo neplatný vstup. Text odpovědi obsahuje podrobnosti o chybě. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 401 – Neautorizováno | Požadavek nebyl ověřen. Klient musí předat platný přístupový token pro platnou cílovou skupinu. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 403 – Zakázáno | Žádost byla ověřena, ale byla odmítnuta, protože volající nemá práva k jejímu vyvolání. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 404 – Nenalezeno | Prostředek nebyl nalezen nebo není k dispozici s danými vstupními parametry. Typy médií: application/json, application/xml, text/xmltext/json |
|
| 500 – Vnitřní chyba serveru | Službě partnerského rozhraní API nebo některé z jejích závislostí se nepodařilo splnit požadavek. Volající můžou žádost opakovat. Typy médií: application/json, application/xml, text/xmltext/json |