下单接口

POST

http://prod-cn.your-api-server.com/order/buy

订单接口

1.将除header外的json字符串拼成body=(json)的形式
2.将所有参数按参数名升序排序
3.将参数用=符号连接参数名和参数值，用&符号连接各参数，字符串尾部拼接&secret=(apiSecret)
4.使用md5 小写32位进行签名
5.注意apiSecret 不要提交
原始串如：apiKey=xh&body={"contactName":"张三","province":"四川省","city":"绵阳市","address":"成都市高新区","phone":"18566295265","orderSubList":[{"productSpecsId":"344332412026617856","price":195.8,"quantity":2}]}&timestamp=1659994981179&secret=123

请求参数

Header 参数

apiKey

string

用户的apiKey

必需

sign

string

签名

必需

timestamp

string

当前时间戳

必需

Body 参数application/json

address

string

收件人地址

可选

buyerOrderId

string

买方订单号

可选

city

string

收件人所在市

可选

contactName

string

收件人姓名

可选

orderSubList

array[object (提交子订单 ModelOrderSubSubmit) {4}]

可选

要购买的商品规格列表

price

number

结算单价

可选

productSpecsId

string

商品规格编号

可选

quantity

integer <int32>

购买数量

可选

remarks

string

买家备注

可选

phone

string

收件人电话

可选

province

string

收件人所在省

可选

returnFullOrder

boolean

可选

是否返回ModelOrder信息,默认false,false返回本平台orderId,true返回整个订单信息

示例值:

false

示例

{
    "address": "string",
    "buyerOrderId": "string",
    "city": "string",
    "contactName": "string",
    "orderSubList": [
        {
            "price": 0,
            "productSpecsId": "string",
            "quantity": 0,
            "remarks": "string"
        }
    ],
    "phone": "string",
    "province": "string",
    "returnFullOrder": false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/order/buy' \
--header 'apiKey;' \
--header 'sign;' \
--header 'timestamp;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address": "string",
    "buyerOrderId": "string",
    "city": "string",
    "contactName": "string",
    "orderSubList": [
        {
            "price": 0,
            "productSpecsId": "string",
            "quantity": 0,
            "remarks": "string"
        }
    ],
    "phone": "string",
    "province": "string",
    "returnFullOrder": false
}'

返回响应

🟢200OK

application/json

Body

code

integer <int32>

可选

状态码，为0表示请求成功，其它则失败

data

string

业务对象

可选

msg

string

错误信息

可选

示例

{
    "code": 0,
    "data": "string",
    "msg": "string"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

修改于 2023-02-22 09:19:03

申请退款接口

确认收货