预约商品 - nkuwiki

为指定商品创建预约，安排线下交易时间。

预约流程：

验证商品状态（必须为可交易状态）

检查预约时间冲突

创建预约记录并锁定时间段

发送预约确认通知给买卖双方

生成预约二维码用于线下验证

预约规则：

同一商品每个用户最多同时存在1个有效预约

预约时间必须在商品的可预约时间段内

预约后商品价格锁定，不受后续调价影响

预约有效期通常为24-48小时

时间段选择：

支持卖家预设的多个时间段

自动推荐最热门的时间段

智能避开高峰时段和周末

预约状态：
创建后状态为 pending，等待卖家确认

权限要求： 需要用户登录，且不能预约自己的商品

Request

Authorization

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

Path Params

Body Params application/jsonRequired

Example

{
    "time_slot": "string",
    "message": "string",
    "contact_info": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Successful Response

Bodyapplication/json

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无法处理的实体