建立API請求 — 無頭設定

瞭解如何使用GraphQL API來無頭地傳遞內容片段內容和資AEM產REST API來管理內容片段。

注意

此功能的某些功能在預發行渠道中可用。特別是與永續查詢相關的功能。

查看預發行渠道文檔有關如何為您的環境啟用該功能的資訊。

什麼是GraphQL和Assets REST API?

GraphQL API 允許您建立訪問和傳遞內容片段的請求。此API提供了一組最強健的功能，用於查詢和使用內容片段內容。
- 要使用它，端點需要在中定義和啟AEM用，如果需要，已安裝GraphiQL介面。
資產REST API 允許您建立和修改內容片段（和其他資產）。

本指南的其餘部分將重點介紹GraphQL訪問和內容片段交付。

必須先建立GraphQL終結點，然後才能使用GraphQL API。

導航到工具。常規，然後選擇 圖形QL。
選擇建立。
的 建立新GraphQL終結點 對話框。您可以在此處指定：
- 名稱:端點名稱；可以輸入任何文本。
- 使用由提供的GraphQL架構:使用下拉清單選擇所需的配置。
確認建立。
在控制台中路徑現在將基於先前建立的配置顯示。這是用於執行GraphQL查詢的路徑。
```
/content/cq:graphql/<configuration-name>/endpoint
```

資訊架構師需要為其渠道端點設計查詢，以便提供內容。通常，每個模型的每個端點只需考慮一次這些查詢。為了完成本入門指南的目的，我們只需建立一個。

GraphiQL是可安裝在環境上的AEMIDE。按照上的步驟操作使用GraphiQL IDE 安裝到您的AEM環境中。

登錄到AEMas a Cloud Service並訪問GraphiQL介面：

可以從以下任一位置訪問查詢編輯器：
- 工具 -> 常規 -> GraphQL查詢編輯器
- 直接；比如說， http://localhost:4502/aem/graphiql.html
GraphiQL IDE是GraphQL的瀏覽器內查詢編輯器。您可以使用它構建查詢以檢索內容片段，以JSON形式無頭地傳遞這些內容片段。
- 右上下拉框允許您選擇端點。
- 最左側的面板列出保留的查詢（如果可用）
- 中左側面板允許您生成查詢。
- 中右面板顯示結果。
- 查詢編輯器具有代碼完成和熱鍵，以便輕鬆執行查詢。
假設我們建立的模型被稱為 person 帶 firstName。 lastName, position，我們可以構建一個簡單的查詢來檢索內容片段的內容。
```
query
{
  personList {
    items {
      _path
      firstName
      lastName
      position
    }
  }
}
```
在左面板中輸入查詢。
按一下 執行查詢 按鈕或 Ctrl-Enter 熱鍵和結果在右面板中顯示為JSON。
按一下文檔連結到頁面右上角以顯示上下文文檔，以幫助您構建適應您自己模型的查詢。