Få kundmedgivande som Kontrollpanelen leverantör

Som Kontrollpanelen 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

Inhämta medgivande

URI-parametrar

Name	I	Krävs	Typ	Description
Kund	path	True	sträng	ID för kunden som genererats i Partnercenter

Begärandehuvud

Medietyper: application/json

Name	Krävs	Typ	Description
Auktorisering	True	sträng	Åtkomsttoken för målgrupp https://api.partnercenter.microsoft.com
Acceptera	True	sträng	Godkänd innehållstyp; allmänt godkänt typprogram/json
ms-correlationid		sträng	Används för att spåra begäranden internt. Om inget ms-correlationid anges genererar servern en ny för varje begäran
ms-requestid		sträng	Används för idempotens för begäranden. Om inget ms-requestid anges genererar servern en ny för varje begäran

Begärandetext

Medietyper: application/json

Namn	Typ	Description
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	Typ	Description
200 OK		Begäran lyckades. Medietyper: "application/json", "application/xml", "text/xml", "text/json"
201 Skapad		Programmedgivandet skapas. Medietyper: "application/json", "application/xml", "text/xml", "text/json"
400 Felaktig begäran		Indata saknas eller är ogiltiga. 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 hittades 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ära igen. Medietyper: "application/json", "application/xml", "text/xml", "text/json"

Definitioner

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

Namn	Typ	Description
enterpriseApplicationId	sträng	GUID-representationen av resursen som får åtkomst
omfång	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}

URI-parametrar

Name	I	Krävs	Typ	Description
Kund	path	True	sträng	ID för kunden som genererats i Partnercenter
Application_id	path	True	sträng	ID för ditt CPV-program

Begärandehuvud

Medietyper: application/json

Name	Krävs	Typ	Description
Auktorisering	True	sträng	Åtkomsttoken för målgrupp https://api.partnercenter.microsoft.com
Acceptera	True	sträng	Godkänd innehållstyp, skriv vanligtvis application/json
ms-correlationid		sträng	Används för att spåra begäranden internt. Om inget ms-correlationid anges genererar servern en ny för varje begäran
ms-requestid		sträng	Används för idempotens för begäranden. Om inget ms-requestid anges genererar servern en ny för varje begäran

Svar

Namn	Typ	Description
200 OK		Begäran lyckades. Medietyper: "application/json", "application/xml", "text/xml", "text/json"
201 Skapad		Programmedgivandet tas bort. Medietyper: "application/json", "application/xml", "text/xml", "text/json"
400 Felaktig begäran		Indata saknas eller är ogiltiga. 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 hittades 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ära igen. Medietyper: "application/json", "application/xml", "text/xml", "text/json"

Nästa steg

• Bekräfta kundens medgivande för kundavtalet