跳轉到主要內容
GraphQL 端點適合你想 塑形響應 的場景——在一次請求裡精確挑選跨多個資料產品的欄位。如果 REST 是”取這一個東西”,GraphQL 就是”回答這一個分析問題”。

端點

或者在 GraphQL IDE 裡互動式探索。

鑑權

兩條等價路徑,按客戶端選擇:
GraphQL 與 REST 共享同一套 API Key 與訂閱配額——無需單獨購買。

第一個查詢

一次請求返回代幣、後設資料與最近成交——沒有 N+1 迴環。

什麼時候用

  • 跨多個資料產品的分析型查詢
  • 欄位多又不想過度抓取的看板
  • 報表 / BI 負載
  • 服務端渲染,預先塑形響應
不建議用 的場景:實時流(用 WebSocket/Kafka)、REST 快取更便宜的熱讀。

從 CLI 呼叫

chainstream CLI 自帶 graphql schema(用於發現)和 graphql query(用於執行)——不必接入客戶端庫也能做快速核查或 shell 自動化:

Schema

Schema 總覽

型別、關係與約定。

入門

第一個查詢的完整走讀。

下一步

GraphQL IDE

互動式探索 schema 與跑查詢。

chainstream-graphql 技能

面向 GraphQL 工作流的結構化 Agent Skill。

CLI `graphql` 子命令

chainstream graphql schemaquery 參考。

SDK

透過 codegen 的型別化 GraphQL 封裝。