Skapa en API-begäran - Headless-konfiguration accessing-delivering-content-fragments
Lär dig hur du använder GraphQL API för headless-leverans av Content Fragment-innehåll och AEM Assets REST API för att hantera innehållsfragment.
Vad är GraphQL och Assets REST API:er? what-are-the-apis
Nu när du har skapat några innehållsfragmentkan du använda AEM API:er för att leverera dem utan problem.
- Med GraphQL-API:t kan du skapa begäranden om åtkomst till och leverans av innehållsfragment. API:t erbjuder den mest robusta uppsättningen funktioner för att fråga efter och konsumera innehåll i innehållsfragment.
- Om du vill använda API:t definierar och aktiverar du slutpunkter i AEM och om det behövs GraphiQL-gränssnittet som är installerat.
- Med Assets REST API kan du skapa och ändra innehållsfragment (och andra resurser).
Resten av guiden fokuserar på GraphQL åtkomst och leverans av innehållsfragment.
Aktivera GraphQL Endpoint enable-graphql-endpoint
Innan GraphQL API:er kan användas måste en GraphQL-slutpunkt skapas.
-
Navigera till Verktyg, Allmänt och välj sedan GraphQL.
-
Välj Skapa.
-
Dialogrutan Skapa ny GraphQL-slutpunkt öppnas. Här kan du ange:
- Namn: slutpunktens namn. Du kan ange valfri text.
- Använd GraphQL-schema från: använd listrutan för att välja den konfiguration som krävs.
-
Bekräfta med Skapa.
-
I konsolen visas en sökväg baserat på konfigurationen som skapades tidigare. Den här sökvägen används för att köra GraphQL-frågor.
code language-none /content/cq:graphql/<configuration-name>/endpoint
Mer information om hur du aktiverar GraphQL-slutpunkter finns i Hantera GraphQL-slutpunkter i AEM.
Fråga innehåll med GraphQL med GraphiQL
Informationsarkitekterna skapar frågor om sina kanalslutpunkter för att leverera innehåll. Ta hänsyn till dessa frågor endast en gång per slutpunkt, per modell. För att komma igång-guiden behöver du bara skapa en.
GraphiQL är en IDE som ingår i AEM. Den är tillgänglig/synlig när du har konfigurerat slutpunkterna.
-
Logga in i AEM as a Cloud Service och öppna GraphiQL-gränssnittet:
Du kan öppna frågeredigeraren från:
- Verktyg > Allmänt > GraphQL Query Editor
- direkt, till exempel
http://localhost:4502/aem/graphiql.html
-
GraphiQL IDE är en frågeredigerare i webbläsaren för GraphQL. Du kan använda den för att skapa frågor för att hämta innehållsfragment och leverera dem i headlessläge som JSON.
- I den nedrullningsbara menyn längst upp till höger kan du välja slutpunkten.
- I en panel längst till vänster visas de beständiga frågorna (om de är tillgängliga)
- På panelen i mitten till vänster kan du skapa din fråga.
- Resultaten visas på panelen i det mittersta högra hörnet.
- Frågeredigeraren har funktioner för kodkomplettering och snabbtangenter för att enkelt köra frågan.
-
Om du utgår ifrån att den modell du skapade anropades med fälten
firstName
,lastName
ochposition
kan du skapa en enkel fråga för att hämta innehållet i innehållsfragmentet.person
code language-text query { personList { items { _path firstName lastName position } } }
-
Skriv frågan i den vänstra panelen.
-
Klicka på knappen Kör fråga eller använd snabbtangenten
Ctrl-Enter
så visas resultatet som JSON i den högra panelen.
-
Klicka på länken Dokument i det övre högra hörnet på sidan om du vill visa sammanhangsberoende dokumentation så att du kan skapa frågor som anpassar sig efter dina egna modeller.
GraphQL möjliggör strukturerade frågor som inte bara kan rikta sig till specifika datauppsättningar eller enskilda dataobjekt, utan även kan leverera specifika element i objekten, kapslade resultat, har stöd för frågevariabler och mycket annat.
GraphQL kan undvika iterativa API-förfrågningar och överleverans, och tillåter istället massleverans av exakt det som behövs för återgivning som svar på en enda API-fråga. Den resulterande JSON kan användas för att leverera data till andra webbplatser eller appar.
Nästa steg next-steps
Så ja! Ni har nu en grundläggande förståelse för innehållshantering utan problem i AEM. Det finns många fler resurser där du kan fördjupa dig för att få en heltäckande bild av de funktioner som finns.
- Innehållsfragment - Mer information om hur du skapar och hanterar innehållsfragment
- Stöd för innehållsfragment i AEM Assets HTTP API - Mer information om hur du får åtkomst till AEM direkt via HTTP API, via CRUD-åtgärder (Create, Read, Update, Delete)
- GraphQL API - Mer information om hur du skickar innehållsfragment utan problem