商業類別 - Fluz

概覽

從 API 取得所有啟用中的商業類別及其子類別。使用此查詢以取得 registerBusiness mutation 所需的 businessCategoryId 與 businessSubCategoryId 值。

必要範圍

Property	Value
Endpoint	GraphQL API
Authentication	OAuth Bearer Token
Required Scopes	`REGISTER_BUSINESS`

參數

此查詢不需要任何參數，且不支援分頁。

基本查詢結構

範例請求：

query GetBusinessCategories {
  getBusinessCategories {
    businessCategoryId
    categoryName
    categoryDescription
    businessSubCategories {
      businessSubCategoryId
      subCategoryName
    }
  }
}

範例回應：

json

{
  "data": {
    "getBusinessCategories": [
      {
        "businessCategoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "categoryName": "Retail Trade",
        "categoryDescription": "Businesses engaged in selling merchandise to consumers",
        "businessSubCategories": [
          {
            "businessSubCategoryId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "subCategoryName": "E-commerce"
          },
          {
            "businessSubCategoryId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "subCategoryName": "Brick and Mortar Retail"
          }
        ]
      },
      {
        "businessCategoryId": "d4e5f6a7-b8c9-0123-defg-234567890123",
        "categoryName": "Professional Services",
        "categoryDescription": "Businesses providing professional or consulting services",
        "businessSubCategories": [
          {
            "businessSubCategoryId": "e5f6a7b8-c9d0-1234-efgh-345678901234",
            "subCategoryName": "Consulting"
          },
          {
            "businessSubCategoryId": "f6a7b8c9-d0e1-2345-fghi-456789012345",
            "subCategoryName": "Legal Services"
          }
        ]
      }
    ]
  }
}

回應細節

Field	Type	Description
`businessCategoryId`	`UUID`	商業類別的唯一識別碼
`categoryName`	`String`	商業類別名稱
`categoryDescription`	`String`	商業類別描述（可能為 null）
`businessSubCategories`	`[BusinessSubCategory]`	此類別底下的子類別清單

BusinessSubCategory

Field	Type	Description
`businessSubCategoryId`	`UUID`	商業子類別的唯一識別碼
`subCategoryName`	`String`	子類別名稱

cURL 範例

curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "query": "query GetBusinessCategories { getBusinessCategories { businessCategoryId categoryName categoryDescription businessSubCategories { businessSubCategoryId subCategoryName } } }"
    }'

注意事項

類別依 categoryName 以字母順序排序。
呼叫 registerBusiness mutation 時，請使用此查詢取得的 businessCategoryId 與 businessSubCategoryId 值。
子類別必須屬於所選的類別，才能在商家註冊期間視為有效。

​概覽

​必要範圍

​參數

​基本查詢結構

​回應細節

​BusinessSubCategory

​cURL 範例

​注意事項

概覽

必要範圍

參數

基本查詢結構

回應細節

BusinessSubCategory

cURL 範例

注意事項