Start Transaction

Develop Env

http://localhost:8000

POST

/trade/start

Start a new transaction as a buyer by providing the item's item_id

Raises

processing_transaction_exists (409)

duplicated_transaction (409)

identical_seller_buyer (409)

invalid_item (404)

no_valid_contact_info (404)

processing_transaction_limit_exceeded (400)

Request

Body Params application/json

Example

{
    "item_id": 0
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:8000/trade/start' \
--header 'Content-Type: application/json' \
--data-raw '{
    "item_id": 0
}'

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "trade_id": 0,
    "buyer": {
        "user_id": 0,
        "campus_id": "string",
        "username": "string",
        "description": "string",
        "created_time": 0
    },
    "item": {
        "item_id": 0,
        "name": "string",
        "description": "string",
        "created_time": 0,
        "price": 0,
        "state": "hide",
        "tags": [
            {
                "tag_id": 0,
                "tag_type": "string",
                "name": "string"
            }
        ],
        "tag_name_list": [
            "string"
        ]
    },
    "created_time": 0,
    "accepted_time": 0,
    "confirmed_time": 0,
    "completed_time": 0,
    "state": "pending",
    "cancel_reason": "seller_rejected"
}

🟠400Bad Request

🟠404Record Not Found

🟠409409

🟠422Parameter Error

Modified at 2024-12-11 01:16:41

Remove All Favourite Items

Accept Transaction