導覽: 平台架構

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 文件,或透過以下頁面與我們聯絡:

👉 https://flowtig.com/contact