Komma åt och leverera innehållsfragment Headless Quick Start Guide

Lär dig använda AEM Assets REST API för att hantera innehållsfragment och GraphQL API för headless-leverans av Content Fragment-innehåll.

Vad är GraphQL och Assets REST API:er?

Nu när du har skapat några innehållsfragment, kan du använda AEM-API:er för att leverera dem utan problem.

Resten av guiden fokuserar på GraphQL åtkomst och leverans av innehållsfragment.

Leverera ett innehållsfragment med GraphQL

Informationsarkitekterna måste utforma frågor för sina kanalslutpunkter för att kunna leverera innehåll. Dessa frågor behöver i allmänhet bara övervägas en gång per slutpunkt och modell. I den här guiden behöver vi bara skapa en.

  1. Logga in AEM och få åtkomst till GraphiQL-gränssnitt:

    • Till exempel: http://<host>:<port>/aem/graphiql.html.

  2. GraphiQL ä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 headlessskick som JSON.

    • I den vänstra panelen kan du skapa din fråga.

    • Resultatet visas på den högra panelen.

    • Frågeredigeraren har funktioner för kodkomplettering och snabbtangenter för att enkelt köra frågan.

      GraphiQL editor

  3. Anta att modellen vi skapade anropades person med fält firstName, lastNameoch positionkan vi skapa en enkel fråga för att hämta innehållet i vårt innehållsfragment.

    query
{
  personList {
    items {
      _path
      firstName
      lastName
      position
    }
  }
}

  4. Skriv frågan i den vänstra panelen.

  5. Klicka på Kör fråga (högerpil) eller använd Ctrl-Enter snabbtangenten och resultatet visas som JSON i den högra panelen.
    GraphiQL-resultat

  6. Klicka på:

    • Dokument längst upp till höger på sidan om du vill visa sammanhangsberoende dokumentation som hjälper dig att skapa frågor som anpassar sig till dina egna modeller.

    • Historik i det övre verktygsfältet om du vill visa tidigare frågor.

    • Spara som och Spara för att spara dina frågor, därefter kan du visa och hämta dem från Beständiga frågor panel och Publicera.

      GraphiQL-dokumentation

GraphQL möjliggör strukturerade frågor som inte bara kan rikta sig till specifika datauppsättningar eller enskilda dataobjekt, utan också kan leverera specifika element i objekten, kapslade resultat, har stöd för frågevariabler och mycket annat.

GraphQL kan undvika både iterativa API-begäranden och överleverans, och i stället tillåter 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

Så ja! Ni har nu en grundläggande förståelse för innehållshantering utan problem i AEM. Det finns förstås många fler resurser där du kan fördjupa dig i en heltäckande bild av de funktioner som finns.

På denna sida