Swifood API Docs
选择语言
选择语言
  • English
  • 简体中文
选择语言
选择语言
  • English
  • 简体中文
  1. Dish Categories
  • Open API Code prompt code list
  • Interface parameter signature process
  • Orders
    • Create Order (General)
      POST
    • Refund Order (General)
      POST
    • Reprint Order Receipt
      POST
    • Calculate Tax
      POST
    • Query Restaurant Orders
      POST
    • Query Order Invoice
      POST
  • Restaurants
    • List Restaurants
      POST
  • Order Callback
    • Restaurant Order Push Callback
      POST
  • Dish Categories
    • Page through dish categories
      POST
    • List dish categories
      POST
    • Create or update a dish category
      POST
    • Delete a dish category
      POST
    • Update a dish category status
      POST
    • Update dish category sort orders
      POST
    • Save category option settings
      POST
  • Options
    • Page through options
      POST
    • List options
      POST
    • Get option details
      POST
    • Create or update an option
      POST
    • Delete an option
      POST
    • List dishes associated with an option
      POST
  • Dishes
    • Page through dishes
      POST
    • List dishes
      POST
    • Get dish details
      POST
    • Create or update a dish
      POST
    • Delete a dish
      POST
    • Update a dish status
      POST
    • Update a dish SKU
      POST
    • Delete a dish SKU
      POST
    • Batch update dish prices
      POST
    • Get dish option settings
      POST
    • Save dish option settings
      POST
  • Menu Templates
    • Page through menu templates
    • Get menu template details
    • Create or update a menu template
    • Delete a menu template
    • Dispatch a menu template
    • Query menu template dispatch results
  • Common Files
    • Upload a dish image
  • 数据模型
    • order
      • ProductInput
      • CreateOrderParam
      • CreateOrderData
      • CreateOrderResponse
      • RefundParam
      • PrintParam
      • TaxCalculateParam
      • TaxItem
      • TaxResponse
      • OrderListParam
      • InvoiceParam
      • OrderListResponse
      • InvoiceJson
      • OrderOption
      • OrderData
      • OrderPushParam
      • OrderSku
      • OptionItem
    • restaurant
      • Restaurant
      • RestaurantListResponse
    • Common
      • SignedRequest
      • ApiResponse
      • PageParam
      • ValidStatus
    • Dish Categories
      • CategoryPageApiResponse
      • CategoryListApiResponse
      • CategoryPageData
      • CategoryApiResp
      • CategoryPageParam
      • CategoryListParam
      • CategorySaveParam
      • CategoryOptionSaveParam
    • Options
      • OptionPageApiResponse
      • OptionListApiResponse
      • OptionDetailApiResponse
      • OptionProductListApiResponse
      • OptionPageData
      • OptionApiResp
      • OptionItemApiResp
      • OptionProductApiResp
      • OptionSaveParam
      • OptionItemCreateParam
      • OptionItemUpdateParam
      • OptionItemDeleteParam
      • OptionProductListParam
      • OptionItemLinkParam
    • Dishes
      • ProductPageApiResponse
      • ProductListApiResponse
      • ProductDetailApiResponse
      • ProductOptionApiResponse
      • ProductPageData
      • ProductApiResp
      • ProductDetailApiResp
      • ProductSpecApiResp
      • ProductSpecItemApiResp
      • ProductSkuApiResp
      • ProductDetailOptionApiResp
      • ProductOptionLinkApiResp
      • ProductQueryParam
      • ProductSaveParam
      • ProductSpecParam
      • ProductStatusParam
      • ProductSkuParam
      • PriceBatchUpdateParam
      • ProductOptionSaveParam
    • Menu Templates
      • TemplatePageApiResponse
      • TemplateDetailApiResponse
      • TemplateDispatchApiResponse
      • TemplateDispatchQueryApiResponse
      • TemplatePageData
      • TemplateApiResp
      • TemplateDetailApiResp
      • TemplateProductApiResp
      • TemplatePermissionApiResp
      • TemplateBranchApiResp
      • TemplateDispatchApiResp
      • TemplateDispatchQueryApiResp
      • TemplatePageParam
      • TemplateSaveParam
      • TemplatePermissionParam
      • TemplateDispatchParam
    • Common Files
      • SignedAppRequest
      • SignedStoreRequest
      • ApiError
      • BooleanResponse
      • UploadFileApiResponse
      • UploadFileApiResp
      • UploadFileParam
  1. Dish Categories

Page through dish categories

POST
/open-api/v1/dish/category/page
The decoded param follows CategoryPageParam.

请求参数

Body 参数application/json必填

示例
{
    "appId": "your-app-id",
    "storeKey": "your-store-key",
    "param": "{}",
    "sign": "generated-signature"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/open-api/v1/dish/category/page' \
--header 'Content-Type: application/json' \
--data '{
    "appId": "your-app-id",
    "storeKey": "your-store-key",
    "param": "{}",
    "sign": "generated-signature"
}'

返回响应

🟢200CategoryPageResponse
application/json
Paged category result
Bodyapplication/json

示例
{
    "code": "string",
    "message": "string",
    "data": {
        "total": 0,
        "list": [
            {
                "categoryNo": "string",
                "name": "string",
                "status": 1,
                "remark": "string",
                "imgUrl": "string",
                "absolutePath": "string",
                "createTime": "2026-11-02 14:30:00",
                "sort": 0,
                "countryTimeZoneCode": "GMT+8"
            }
        ]
    }
}
修改于 2026-11-02 09:57:21
上一页
Restaurant Order Push Callback
下一页
List dish categories
Built with