Sdílet prostřednictvím

Získání souhlasu zákazníka jako dodavatele Ovládací panely

  • Článek

Jako Ovládací panely dodavatel (CPV) můžete pomocí rozhraní REST API získat a odebrat souhlas zákazníků CSP, aby získali oprávnění do svých tenantů.

POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents

Parametry identifikátoru URI

Name V Požaduje se Typ Description
customer_id program True řetězec ID zákazníka vygenerovaného v Partnerském centru

Hlavička požadavku

Typy médií: application/json

Name Požaduje se Typ Description
Autorizace True řetězec Přístupový token pro cílovou skupinu https://api.partnercenter.microsoft.com
Přijmout True ř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 ms-correlationid není zadaný, server pro každý požadavek vygeneruje nový.
ms-requestid řetězec Používá se pro idempotenci požadavků. Pokud ms-requestid není zadaný, server pro každý požadavek vygeneruje nový.

Text požadavku

Typy médií: application/json

Název Typ Description
applicationId řetězec ID aplikace partnera CPV
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] Seznam grantů aplikací pro získání přístupu pro zákazníky v jejich tenantovi

Odpovědi

Název Typ Description
200 OK Žádost byla úspěšná. Typy médií: "application/json", "application/xml", "text/xml", "text/json"
201 Vytvořeno Vytvoří se souhlas aplikace. Typy médií: "application/json", "application/xml", "text/xml", "text/json"
400 – Chybný požadavek Chybí nebo je 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 Požadavek byl ověřen, ale byl odmítnut, protože volající nemá práva k jeho vyvolání. Typy médií: "application/json", "application/xml", "text/xml", "text/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/xml", "text/json"
500 – Vnitřní chyba serveru Službě partnerského rozhraní API nebo některé z jejích závislostí se nepodařilo požadavek splnit. Volající můžou žádost zopakovat. Typy médií: "application/json", "application/xml", "text/xml", "text/json"

Definice

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

Název Typ Description
enterpriseApplicationId řetězec Reprezentace GUID prostředku, který získá přístup
scope řetězec Hodnoty oddělené čárkami oboru pro získání přístupu 
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

Parametry identifikátoru URI

Name V Požaduje se Typ Description
customer_id program True řetězec ID zákazníka vygenerovaného v Partnerském centru
Application_id program True řetězec ID aplikace CPV

Hlavička požadavku

Typy médií: application/json

Name Požaduje se Typ Description
Autorizace True řetězec Přístupový token pro cílovou skupinu https://api.partnercenter.microsoft.com
Přijmout True řetězec Přijatelný typ obsahu, obvykle typ application/json
ms-correlationid řetězec Používá se pro interní sledování požadavků. ms-correlationid Pokud není zadaný, server pro každý požadavek vygeneruje nový.
ms-requestid řetězec Používá se pro idempotenci požadavků. Pokud ms-requestid není zadaný, server pro každý požadavek vygeneruje nový.

Odpovědi

Název Typ Description
200 OK Žádost byla úspěšná. 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 Chybí nebo je 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 Požadavek byl ověřen, ale byl odmítnut, protože volající nemá práva k jeho vyvolání. Typy médií: "application/json", "application/xml", "text/xml", "text/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/xml", "text/json"
500 – Vnitřní chyba serveru Službě partnerského rozhraní API nebo některé z jejích závislostí se nepodařilo požadavek splnit. Volající můžou žádost zopakovat. Typy médií: "application/json", "application/xml", "text/xml", "text/json"

Další kroky