Upload a dish image

POST

/open-api/v1/common/file/upload

Uploads a category image, product menu image, or product detail image.

The request must use multipart/form-data and contain two parts:

request: Required. Its Content-Type must be application/json, and its content must be the complete signed Open API request.

file: Required. The image file to upload. JPG/JPEG, PNG, and WEBP are supported. The maximum file size is 5 MB.

param only needs to contain businessType. Supported values are CATEGORY_IMAGE (category image), PRODUCT_MENU_IMAGE (product menu image), and PRODUCT_DETAIL_IMAGE (product detail image).

Do not send the file name, file size, Content-Type, or SHA-256 checksum; the server obtains or calculates them from the uploaded file.

Generate sign in the same way as for other Open APIs: sign the exact UTF-8 text of param with the developer private key using SHA256withRSA, then Base64-encode the signature bytes.

请求参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/open-api/v1/common/file/upload' \
--form 'request="{\"appId\":\"your-app-id\",\"storeKey\":\"your-store-key\",\"param\":\"{\\\"businessType\\\":\\\"PRODUCT_MENU_IMAGE\\\"}\",\"sign\":\"generated-signature\"}";type=application/json' \
--form 'file=@"C:\\Users\\17650\\Desktop\\027aa0a4-8203-44b1-85fd-a83bee581e1f.png"'

返回响应

🟢200

application/json

Request processed. Use code and message to determine the business result.

Bodyapplication/json

示例

{
    "code": 0,
    "message": "string",
    "messageIn": "string",
    "data": {
        "fileKey": "string",
        "url": "string",
        "size": 0,
        "contentType": "string",
        "sha256": "string"
    }
}

修改于 2026-11-03 07:12:29

Query menu template dispatch results

ProductInput