OpenAPI-baserade API:er
Nyare AEM as a Cloud Service-API:er följer OpenAPI-specifikationen och erbjuder därmed en konsekvent och väldokumenterad uppsättning API:er.
OBSERVERAFör slutpunkter som kräver autentisering skiljer sig autentiseringsmetoden från slutpunkten, men kan använda OAuth Server-to-Server, OAuth Web App eller OAuth Single Page App (SPA). Autentiseringsuppgifter konfigureras via projekt i Adobe Developer Console.
Vanliga API-användningsfall omfattar integreringar med system som CRM eller PIM, där AEM API:er anropas för att hämta eller behålla data. Som en del av integreringsimplementeringen kan program prenumerera på händelser som skickas från AEM, vilket kan utlösa affärslogik i Adobe App Builder eller annan infrastruktur.
Det här dokumentet fungerar som en översikt, men mer ingående dokumentation finns på följande sidor:
-
Länkarna från det OpenAPI-baserade API-avsnittet i referensdokumentationen. Varje API:s referensdokumentation innehåller också en API-spelningsbakgrund, vilket gör det enkelt att testa en slutpunkt med en bearer-token som genererats med Adobe Developer Console.
-
Informativa guider, inklusive API-koncept och syntax.
-
En självstudiekurs på den översta nivån som beskriver autentiseringsmetoder och andra koncept.
-
En självstudiekurs med video som fokuserar på hur du konfigurerar OpenAPI-baserade API:er.
-
En självstudiekurs från början till slut om hur du konfigurerar och anropar OpenAPI:er med autentiseringsstrategin server-till-server. Liknande självstudiekurser finns också för autentiseringsmetoderna Web App och Single Page Application.
Konfigurera API-åtkomst
Vissa OpenAPI-baserade AEM-API:er behöver autentiseras, vilket kräver att autentiseringsuppgifter genereras med Adobe Developer Console. Konfiguration omfattar följande steg:
- Modernisering av AEM as a Cloud Service. Mer information finns i Modernisering av AEM as a Cloud Service-miljön - självstudiekurs.
- Ge åtkomst till AEM API:er med produktprofiler. Produktprofiler är kopplade till de tjänster som representerar AEM användargrupper med fördefinierade åtkomstkontrollistor (ACL). Vissa tjänster är som standard associerade med specifika produktprofiler, men andra måste uttryckligen kopplas. AEM Assets API-användartjänst är till exempel inte associerad med någon produktprofil, så du måste aktivera den för att kunna använda AEM Assets API. Mer information finns i Aktivera åtkomst till AEM API:er självstudiekurs.
- Om du vill lägga till server-till-server-autentisering måste den användare som ställer in integreringen vara organisationens systemadministratör i Adobe Admin Console eller läggas till som utvecklare i den produktprofil där tjänsten är kopplad. Mer information finns i Aktivera åtkomst till AEM API:er självstudiekurs.
- Skapa ett Adobe Developer Console-projekt (ADC).
- Konfigurera ADC-projektet. Detta genererar autentiseringsuppgifter som ska användas senare för utbyte mot en innehavartoken när API anropas.
- Konfigurera AEM-instansen för att aktivera ADC-projektkommunikation. Detta innebär att registrera klient-ID:t i miljön genom att konfigurera och distribuera en YAML-fil, vilket beskrivs i avsnittet Registrera ett klient-ID nedan.
Detaljerade stegvisa instruktioner finns i självstudiekursen Konfigurera OpenAPI-baserade API:er.