编辑单品（部分更新；换图只接受新 receipt）

PATCH

/api/items/{id}

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Path 参数

Header 参数

Body 参数application/json必填

示例

{
    "uploadReceipts": [
        "string"
    ],
    "images": {},
    "thumbUrl": {},
    "imageHash": {},
    "category": "top",
    "wearSlots": "top",
    "subCategory": "string",
    "name": "string",
    "brand": "string",
    "note": "string",
    "colors": [
        {
            "key": "黑",
            "hex": "string"
        }
    ],
    "material": "棉",
    "style": "极简",
    "seasons": "春",
    "occasions": "通勤",
    "weatherTraits": "waterproof",
    "fitHeight": {
        "min": 100,
        "max": 100
    },
    "warmth": 1,
    "formality": 1,
    "customValues": {}
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '/api/items/' \
--header 'authorization: Bearer {{token}}' \
--header 'Authorization: Bearar {{beararToken}} <token>' \
--header 'Content-Type: application/json' \
--data '{
    "uploadReceipts": [
        "string"
    ],
    "images": {},
    "thumbUrl": {},
    "imageHash": {},
    "category": "top",
    "wearSlots": "top",
    "subCategory": "string",
    "name": "string",
    "brand": "string",
    "note": "string",
    "colors": [
        {
            "key": "黑",
            "hex": "string"
        }
    ],
    "material": "棉",
    "style": "极简",
    "seasons": "春",
    "occasions": "通勤",
    "weatherTraits": "waterproof",
    "fitHeight": {
        "min": 100,
        "max": 100
    },
    "warmth": 1,
    "formality": 1,
    "customValues": {}
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {},
    "timestamp": "2026/9/27 12:00:00",
    "message": "success"
}

修改于 2026-09-27 12:37:06

单品详情

软删除单品（写 deletedAt，不等于归档）