GraphQL API
每個 Flowtig 應用程式的主要 API。
GraphQL 是在 Flowtig 平台上建立應用程式的主要介面。
所有業務應用程式——包括聯絡人、工時管理、工時追蹤、發票及倉庫——都透過 GraphQL 進行通訊。此 API 提供對租戶專屬業務資料的強型別存取,同時自動執行權限控制及組織邊界隔離。
為什麼使用 GraphQL?
Flowtig 使用 GraphQL,是因為不同應用程式需要不同的資料,同時又共用相同的平台。
GraphQL 讓每個用戶端都能精確取得所需資料,不需要額外的網路請求,也不需要建立重複的端點。
典型優勢包括:
- 強型別
- 精確選擇所需欄位
- 可預測的 Schema
- 具備自我描述能力的 API
- 高效率的資料取得
我可以建立什麼?
每個 Flowtig 應用程式都透過 GraphQL 進行通訊。
例如:
每個應用程式負責自己的業務領域,同時共用相同的驗證及權限模型。
租戶隔離
每個 GraphQL 請求都會在單一組織的環境中執行。
平台會自動強制執行:
- 租戶隔離
- 成員資格驗證
- 服務權限
- 物件層級授權
應用程式不需要手動切換資料庫,也不需要自行依照組織篩選資料。
更多資訊請參閱架構指南。
Query 與 Mutation
GraphQL 提供兩種主要的操作類型。
Query
當您需要取得資訊時,可以使用 Query。
典型範例包括:
- 取得聯絡人
- 取得發票
- 載入專案
- 搜尋倉庫物品
Mutation
當需要建立、更新或刪除資料時,可以使用 Mutation。
典型範例包括:
- 建立發票
- 更新聯絡人
- 刪除倉庫物品
- 完成工作
Schema 設計
每個 Flowtig 應用程式都擁有自己的 GraphQL Schema。
如此可以讓各個業務領域保持清楚分離,同時讓應用程式能夠彼此獨立發展。
平台鼓勵:
- 清楚的 Schema 所有權
- 一致的命名方式
- 強型別
- 穩定的契約
互動式文件
完整的 GraphQL Schema 可以透過互動式 GraphQL Explorer 查看。
您可以在其中:
- 瀏覽所有型別
- 查看可用的 Query
- 探索 Mutation
- 檢視資料之間的關聯
- 執行測試 Query
👉 https://api.flowtig.com/graphql/docs
相關文件
您可能也會對以下內容感興趣:
需要協助嗎?
對 GraphQL API 有任何問題?
您可以查看互動式 API 文件,或透過以下頁面與我們聯絡: