更新预约状态

更新预约的状态，通常由买卖双方共同操作完成交易流程。

路径参数：

booking_id：预约ID

支持的状态变更：

买家操作：

pending → cancelled：买家取消预约

confirmed → completed：买家确认交易完成

卖家操作：

pending → confirmed：卖家确认预约

pending → rejected：卖家拒绝预约

confirmed → completed：卖家确认交易完成

系统操作：

confirmed → expired：预约过期未交易

confirmed → no_show：预约时间无人到场

业务规则：

状态变更会触发相应的通知

重要状态变更会被记录到交易历史

取消预约可能产生信用影响

权限控制：

买家只能操作自己的预约

卖家只能操作他人对自己商品的预约

管理员可以操作所有预约状态

权限要求： 需要用户登录，只能操作相关预约

OAuth 2.0

Password

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: /api/v1/auth/login

Responses

🟢200成功

application/json

Successful Response

Body

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "like_count": 0,
        "favorite_count": 0,
        "share_count": 0,
        "comment_count": 0,
        "view_count": 0,
        "is_pinned": false,
        "is_global_pinned": false,
        "pinned_at": "2019-08-24T14:15:22.123Z",
        "pinned_weight": 0,
        "is_liked": false,
        "is_favorited": false,
        "is_commented": false,
        "is_following": false,
        "is_followed": false,
        "time_slot": "string",
        "message": "string",
        "contact_info": "string",
        "listing_id": "5322d4a9-51d2-4408-82fb-01ffecfb8304",
        "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
        "seller_id": "28f4dc41-8499-4ead-9976-f2fa20a45fd1",
        "status": "pending",
        "listing": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
            "created_at": "2019-08-24T14:15:22.123Z",
            "updated_at": "2019-08-24T14:15:22.123Z",
            "like_count": 0,
            "favorite_count": 0,
            "share_count": 0,
            "comment_count": 0,
            "view_count": 0,
            "is_pinned": false,
            "is_global_pinned": false,
            "pinned_at": "2019-08-24T14:15:22.123Z",
            "pinned_weight": 0,
            "is_liked": false,
            "is_favorited": false,
            "is_commented": false,
            "is_following": false,
            "is_followed": false,
            "title": "string",
            "content": "string",
            "category_id": "string",
            "listing_type": "buy",
            "price": "string",
            "condition": "new",
            "location": "string",
            "tags": [
                "string"
            ],
            "images": [
                "string"
            ],
            "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
            "user": {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
                "created_at": "2019-08-24T14:15:22.123Z",
                "updated_at": "2019-08-24T14:15:22.123Z",
                "like_count": 0,
                "favorite_count": 0,
                "share_count": 0,
                "comment_count": 0,
                "view_count": 0,
                "is_pinned": false,
                "is_global_pinned": false,
                "pinned_at": "2019-08-24T14:15:22.123Z",
                "pinned_weight": 0,
                "is_liked": false,
                "is_favorited": false,
                "is_commented": false,
                "is_following": false,
                "is_followed": false,
                "nickname": "string",
                "status": "active",
                "avatar": "string",
                "bio": "string",
                "birthday": "2019-08-24",
                "school": "string",
                "college": "string",
                "location": "string",
                "wechat_id": "string",
                "qq_id": "string",
                "tel": "string",
                "level": 0
            },
            "status": "active",
            "booking_count": 0,
            "category": {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
                "created_at": "2019-08-24T14:15:22.123Z",
                "updated_at": "2019-08-24T14:15:22.123Z",
                "like_count": 0,
                "favorite_count": 0,
                "share_count": 0,
                "comment_count": 0,
                "view_count": 0,
                "is_pinned": false,
                "is_global_pinned": false,
                "pinned_at": "2019-08-24T14:15:22.123Z",
                "pinned_weight": 0,
                "is_liked": false,
                "is_favorited": false,
                "is_commented": false,
                "is_following": false,
                "is_followed": false,
                "name": "string",
                "description": "string",
                "icon": "string",
                "sort_order": 0,
                "parent_id": "1c6ca187-e61f-4301-8dcb-0e9749e89eef",
                "children": [
                    {}
                ]
            },
            "similar_listings": [
                {}
            ]
        },
        "buyer": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
            "created_at": "2019-08-24T14:15:22.123Z",
            "updated_at": "2019-08-24T14:15:22.123Z",
            "like_count": 0,
            "favorite_count": 0,
            "share_count": 0,
            "comment_count": 0,
            "view_count": 0,
            "is_pinned": false,
            "is_global_pinned": false,
            "pinned_at": "2019-08-24T14:15:22.123Z",
            "pinned_weight": 0,
            "is_liked": false,
            "is_favorited": false,
            "is_commented": false,
            "is_following": false,
            "is_followed": false,
            "nickname": "string",
            "status": "active",
            "avatar": "string",
            "bio": "string",
            "birthday": "2019-08-24",
            "school": "string",
            "college": "string",
            "location": "string",
            "wechat_id": "string",
            "qq_id": "string",
            "tel": "string",
            "level": 0
        },
        "seller": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
            "created_at": "2019-08-24T14:15:22.123Z",
            "updated_at": "2019-08-24T14:15:22.123Z",
            "like_count": 0,
            "favorite_count": 0,
            "share_count": 0,
            "comment_count": 0,
            "view_count": 0,
            "is_pinned": false,
            "is_global_pinned": false,
            "pinned_at": "2019-08-24T14:15:22.123Z",
            "pinned_weight": 0,
            "is_liked": false,
            "is_favorited": false,
            "is_commented": false,
            "is_following": false,
            "is_followed": false,
            "nickname": "string",
            "status": "active",
            "avatar": "string",
            "bio": "string",
            "birthday": "2019-08-24",
            "school": "string",
            "college": "string",
            "location": "string",
            "wechat_id": "string",
            "qq_id": "string",
            "tel": "string",
            "level": 0
        }
    }
}

🟠422无法处理的实体

更新预约状态

Request

Request Code Samples

Responses