编辑单品（PUT 别名，与 PATCH 同一处理）

PUT

/api/items/{id}

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Path 参数

Body 参数application/json必填

示例

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

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "id": 0,
        "status": "string",
        "category": "string",
        "wearSlots": [
            "string"
        ],
        "subCategory": "string",
        "name": "string",
        "brand": "string",
        "note": "string",
        "images": [
            "string"
        ],
        "thumbUrl": "string",
        "imageHash": "string",
        "importBatchId": 0,
        "clientItemId": "string",
        "colors": [
            {
                "key": "黑",
                "hex": "string"
            }
        ],
        "material": [
            "string"
        ],
        "style": [
            "string"
        ],
        "seasons": [
            "string"
        ],
        "weatherTraits": [
            "string"
        ],
        "fitHeight": {
            "min": 100,
            "max": 100
        },
        "warmth": 0,
        "formality": 0,
        "occasions": [
            "string"
        ],
        "customValues": {},
        "source": "string",
        "aiDraft": {},
        "aiConfidence": {},
        "manualFields": [
            "string"
        ],
        "recognitionStatus": "string",
        "recognitionError": "string",
        "wearCount": 0,
        "favoriteCount": 0,
        "lastWornAt": 0,
        "lastRecommendedAt": 0,
        "createdAt": 0,
        "updatedAt": 0,
        "deletedAt": 0
    },
    "timestamp": "2026/9/27 12:00:00",
    "message": "success"
}

修改于 2026-09-30 12:52:15

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

手工标记单件穿着（幂等；一次动作一条 wear_event）