Získání souhlasu zákazníka jako dodavatele Ovládacích panelů
Jako dodavatel ovládacích panelů (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
| Jméno | V | Povinný | Typ | Popis |
|---|---|---|---|---|
| identifikátor zákazníka | cesta | Pravda | řetězec | ID zákazníka vygenerovaného v Partnerském centru |
Hlavička požadavku
Typy médií: application/json
| Jméno | Povinný | Typ | Popis |
|---|---|---|---|
| Oprávnění | Pravda | řetězec | Přístupový token pro cílovou skupinu https://api.partnercenter.microsoft.com |
| Přijmout | Pravda | řetězec | Přijatelný typ obsahu; široce přijímaný typ application/json |
| ms-correlationid | řetězec | 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 | řetězec | Používá se k idempotenci požadavků. Pokud není zadaný identifikátor ms-requestid, server pro každý požadavek vygeneruje nový. |
Tělo žádosti
Typy médií: application/json
| Jméno | Typ | Popis |
|---|---|---|
| applicationId | řetězec | ID aplikace partnera CPV |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Seznam aplikací pro udělení přístupu vašim zákazníkům v jejich tenantovi. |
Odpovědi
| Jméno | Typ | Popis |
|---|---|---|
| 200 OK | Požadavek byl úspěšný. Typy médií: application/json, application/xml, text/xml, text/json |
|
| 201 Vytvořeno | Souhlas aplikace byl vytvořen. Typy médií: application/json, application/xml, text/xml, text/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/xml, text/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/xml, text/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/xml, text/json |
|
| 404 Nenalezena | Prostředek nebyl nalezen nebo není k dispozici s danými vstupními parametry. Typy médií: application/json, application/xml, text/xml, text/json |
|
| Vnitřní chyba serveru 500 | 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/xml, text/json |
Definice
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Jméno | Typ | Popis |
|---|---|---|
| EnterpriseApplicationId | řetězec | Reprezentace identifikátoru GUID prostředku, který získává přístup |
| rozsah | řetězec | Čárkami oddělené hodnoty rozsahu pro získání přístupu |
Odstranit souhlas
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
| Jméno | V | Povinný | Typ | Popis |
|---|---|---|---|---|
| identifikátor zákazníka | cesta | Pravda | řetězec | ID zákazníka vygenerovaného v Partnerském centru |
| Application_id | cesta | Pravda | řetězec | ID vaší aplikace CPV |
Hlavička požadavku
Typy médií: application/json
| Jméno | Povinný | Typ | Popis |
|---|---|---|---|
| Oprávnění | Pravda | řetězec | Přístupový token pro cílovou skupinu https://api.partnercenter.microsoft.com |
| Přijmout | Pravda | řetězec | Přijatelný typ obsahu, obvykle typ application/json |
| ms-correlationid | řetězec | Používá se pro interní sledování požadavků. Pokud není zadaný ms-correlationid, server pro každý požadavek vygeneruje nový. |
|
| ms-requestid | řetězec | Používá se pro idempotentnost požadavků. Pokud není zadaný identifikátor ms-requestid, server pro každý požadavek vygeneruje nový. |
Odpovědi
| Jméno | Typ | Popis |
|---|---|---|
| 200 OK | Požadavek se zdařil. Typy médií: application/json, application/xml, text/xml, text/json |
|
| 201 Vytvořeno | Souhlas aplikace se odstraní. Typy médií: application/json, application/xml, text/xml, text/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/xml, text/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/xml, text/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/xml, text/json |
|
| 404 Nenalezena | Prostředek nebyl nalezen nebo není k dispozici s danými vstupními parametry. Typy médií: application/json, application/xml, text/xml, text/json |
|
| Vnitřní chyba serveru 500 | 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/xml, text/json |