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

POST

/api/items/{id}/wear

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Path 参数

Body 参数application/json必填

示例

{
    "timezone": "Asia/Shanghai",
    "idempotencyKey": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/items//wear' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "timezone": "Asia/Shanghai",
    "idempotencyKey": "string"
}'

返回响应

🟢201

application/json

Bodyapplication/json

示例

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

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

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

创建导入批次（clientRequestId 幂等）