交易

用户名密码登录

URL：/app-api/member/auth/login
Method：POST
需要鉴权：是

请求参数

参数	类型	是否必传	约束
mobile	String	是	15601691301
password	String	是	admin123

请求示例

{ "mobile": "15601691301", "password": "admin123" }

响应示例

{
    "code": 0,
    "data": {
        "userId": 1024,
        "accessToken": "happy",
        "refreshToken": "nice",
        "expiresTime": "",
        "openid": "qq768"
    },
    "msg": ""
}

响应说明

参数	类型	说明
code	Number	200成功其他失败
userId	Number	用户编号
accessToken	String	访问令牌
refreshToken	String	刷新令牌
expiresTime	String	过期时间
openid	String	社交用户 openid

创建订单前-订单结算信息

URL：/app-api/trade/order/settlement
Method：POST
需要鉴权：是

说明

从购物车下单时，购物车中可以多选并进行下单，在进行下单前，需要调用本接口获取当前选中的商品的结算信息，包括价格、优惠券（可用及不可用的均返回）；
用户选中可以使用的优惠券后，需要调用本接口重新获取结算价格；
使用积分支付时：积分商城的调用方式：pointStatus = true 和 pointActivityId 必传；

请求参数

参数	类型	约束
items		购物项数组
skuId	Long	sku编号
count	Long	数量
cartId	Long	购物车编号
couponId	Long	优惠券编号
deliveryType	Long	配送方式1 快递发货2自提（默认传1）实物传1 虚拟传2
addressId	Long	收件地址编号
receiverName	String	收件人名称
receiverMobile	String	收件人手机
pointStatus		是否使用积分true:是false:否
pointActivityId	Long	积分商城活动字段

请求示例

{
  "items": [
    {
      "skuId": 33,
      "count": 2,
      "cartId": 100
    },
    {
      "skuId": 32,
      "count": 1,
      "cartId": 99
    }
  ],
  "couponId": 47,
  "pointStatus": false,
  "deliveryType": 1,
  "addressId": 47,
  "receiverName": "芋艿",
  "receiverMobile": "15601691300"
}

响应示例

{
    "code": 0,
    "data": {
        "type": 0,
        "items": [
            {
                "categoryId": 28,
                "spuId": 640,
                "spuName": "商城测试商品",
                "skuId": 33,
                "price": 1000,
                "picUrl": "http://test.yudao.iocoder.cn/9c6f8897bf5b3baa457b056cdfd3edebb4c5def6b2f241267b5d6903606358af.png",
                "properties": [
                    {
                        "propertyId": 1,
                        "propertyName": "颜色",
                        "valueId": 6,
                        "valueName": "蓝色"
                    },
                    {
                        "propertyId": 16,
                        "propertyName": "重量",
                        "valueId": 30,
                        "valueName": "大"
                    }
                ],
                "cartId": null,
                "count": 2
            }
        ],
        "coupons": [
            {
                "id": 47,
                "name": "满10元减5元券",
                "usePrice": 1000,
                "validStartTime": 1732896000000,
                "validEndTime": 1735660799000,
                "discountType": 1,
                "discountPercent": 90,
                "discountPrice": 500,
                "discountLimitPrice": 9999900,
                "match": true,
                "mismatchReason": null
            }
        ],
        "price": {
            "totalPrice": 3000,
            "discountPrice": 0,
            "deliveryPrice": 0,
            "couponPrice": 500,
            "pointPrice": 0,
            "vipPrice": 0,
            "payPrice": 2500
        },
        "address": {
            "id": 47,
            "name": "吕",
            "mobile": "18612982936",
            "areaId": 110101,
            "areaName": "北京市 北京市 东城区",
            "detailAddress": "兴创国际中心",
            "defaultStatus": true
        },
        "usePoint": 0,
        "totalPoint": 0,
        "promotions": [
            {
                "id": 47,
                "name": "满10元减5元券",
                "type": 7,
                "totalPrice": 3000,
                "discountPrice": 500,
                "items": [
                    { "skuId": 33, "totalPrice": 2000, "discountPrice": 333 },
                    { "skuId": 32, "totalPrice": 1000, "discountPrice": 167 }
                ],
                "match": true,
                "description": "优惠劵：省 5.00 元"
            }
        ]
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
type	Long	订单类型0：商城订单
usePoint	Long	已使用的积分
totalPoint	Long	总积分
items		订单商品购物项数组
categoryId	Long	品类编号
spuId	Long	SPU 编号
spuName	String	SPU 名字
skuId	Long	SKU 编号
price	Long	SKU 价格，单位：分
picUrl	String	SKU 图片地址
properties		属性数组
cartId	Long	购物车编号
count	Long	下单数量
coupons		优惠券信息数组
address		地址对象
price		费用对象
totalPrice	Long	商品原价（总），单位：分
discountPrice	Long	订单优惠（总），单位：分
deliveryPrice	Long	运费金额，单位：分
couponPrice	Long	优惠劵减免金额，单位：分
pointPrice	Long	积分抵扣的金额，单位：分
vipPrice	Long	VIP 减免金额，单位：分
payPrice	Long	实际支付金额（总），单位：分
promotions		营销活动数组
match	Boolean	是否满足优惠条件
description	String	满足条件的提示

下单前校验-是否可以下单

URL：/app-api/trade/order/validateIsToBuy
Method：POST
需要鉴权：是

请求参数

参数	类型	约束
spuId	Long	商品spuId
buyCount	Long	下单购买数量

请求示例

[
    { "spuId": 1008, "buyCount": 6 },
    { "spuId": 1009, "buyCount": 1 }
]

响应示例

{
    "code": 0,
    "data": true,
    "msg": "成功"
}

响应说明

参数	类型	约束
data	Boolean	true 可以继续下单，其他均不可下单

创建订单

URL：/app-api/trade/order/create
Method：POST
需要鉴权：是

说明

从购物车下单时，购物车中可以多选并进行下单，即可以下单多个商品。

请求参数

参数	类型	是否必传	约束
items	数组	是	选中商品数组
skuId	Number	是	商品 SKU 编号
count	Number	是	购买数量
cartId	Number	否	购物车项的编号
hospitalPrescriptionId	Number	否	如果有，说明是处方单药品，则传
type	Number	否	订单类型：0-普通订单（默认）1-秒杀订单2-砍价订单3-拼团订单4-积分商城
couponId	Number	否	优惠劵编号，如果有可用的，则传一个
pointStatus	boolean	是	是否使用积分true:是false:否
deliveryType	Number	是	配送方式1 快递发货2自提（默认传1）实物传1 虚拟传2
addressId	Number	是	收件地址编号
pickUpStoreId	Number	否	自提门店编号
receiverName	String	否	收件人名称
receiverMobile	String	否	收件人手机
seckillActivityId	Number	否	秒杀活动编号
combinationActivityId	Number	否	拼团活动编号
combinationHeadId	Number	否	拼团团长编号
bargainRecordId	Number	否	砍价记录编号
pointActivityId	Number	否	积分活动的编号
remark	String	否	备注

请求示例

{
  "items": [
    { "skuId": 33, "count": 2, "cartId": 100 },
    { "skuId": 32, "count": 1, "cartId": 99 }
  ],
  "pointStatus": false,
  "deliveryType": 1,
  "addressId": 47,
  "receiverName": "芋艿",
  "receiverMobile": "15601691300",
  "remark": "这个是我的订单哟"
}

响应示例

{
    "code": 0,
    "data": {
        "id": 1024,
        "payOrderId": 1024
    },
    "msg": ""
}

响应说明

参数	类型	说明
id	Number	订单数据编号
payOrderId	Number	支付单数据编号

获取订单分页

URL：/app-api/trade/order/page
Method：POST
需要鉴权：是

请求参数

参数	类型	是否必传	约束
userId	Number	是	用户id
pageNo	Number	是	页码
pageSize	Number	是	每页条数
status	Number	否	实物订单0 待支付10 待发货20 已发货30 已完成40 已取消全部不传
commentStatus	Boolean	否	订单类型true:已评价false:未评价

请求示例

{
  "pageNo": 1,
  "pageSize": 10,
  "status": 0,
  "commentStatus": true
}

响应示例

{
    "code": 0,
    "data": {
        "list": [
            {
                "id": 1024,
                "no": "1146347329394184195",
                "type": 0,
                "status": 1,
                "productCount": 10,
                "commentStatus": true,
                "createTime": "",
                "payOrderId": 1024,
                "payPrice": 1000,
                "deliveryType": 1,
                "items": [
                    {
                        "id": 1,
                        "orderId": 1024,
                        "spuId": 1,
                        "spuName": "芋道源码",
                        "skuId": 1,
                        "properties": [
                            { "propertyId": 1, "propertyName": "颜色", "valueId": 1024, "valueName": "红色" }
                        ],
                        "picUrl": "https://www.iocoder.cn/1.png",
                        "count": 1,
                        "commentStatus": true,
                        "price": 100,
                        "payPrice": 50,
                        "afterSaleId": 1024,
                        "afterSaleStatus": 1
                    }
                ],
                "combinationRecordId": 100
            }
        ],
        "total": 0
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
id	Number	订单编号
no	Number	订单流水号
type	Number	订单类型0-普通订单（默认）
status	Number	订单状态0-待支付 10-待发货 20-已发货 30-已完成 40-已取消
productCount	Number	购买的商品数量
commentStatus	boolean	是否评价true-已评价 false-未评价
createTime	String	创建时间
payOrderId	Number	支付订单编号
payPrice	Number	应付金额，单位：分
deliveryType	Number	配送方式1-快递
combinationRecordId	Number	拼团记录编号
items	数组	订单商品项

获取订单详情

URL：/app-api/trade/order/getOrderDetail
Method：GET
需要鉴权：是

请求参数

参数	类型	是否必传	约束
id	Number	是	交易订单编号即订单数据编号

请求示例

GET /app-api/trade/order/getOrderDetail?id=225

响应示例

{
    "code": 0,
    "data": {
        "id": 225,
        "no": "o202411180027541",
        "type": 0,
        "createTime": 1731860879000,
        "userRemark": "这个是我的订单哟",
        "status": 0,
        "productCount": 3,
        "finishTime": null,
        "cancelTime": null,
        "commentStatus": false,
        "payStatus": false,
        "payOrderId": 469,
        "payTime": null,
        "payExpireTime": 1731947279000,
        "payChannelCode": null,
        "payChannelName": null,
        "totalPrice": 500,
        "discountPrice": 0,
        "deliveryPrice": 0,
        "adjustPrice": 0,
        "payPrice": 500,
        "deliveryType": 1,
        "logisticsId": null,
        "logisticsName": null,
        "logisticsNo": null,
        "deliveryTime": null,
        "receiveTime": null,
        "receiverName": "吕",
        "receiverMobile": "18612982936",
        "receiverAreaId": 110101,
        "receiverAreaName": "北京市 北京市 东城区",
        "receiverDetailAddress": "兴创国际中心",
        "pickUpStoreId": null,
        "pickUpVerifyCode": null,
        "refundStatus": 0,
        "refundPrice": 0,
        "couponId": null,
        "couponPrice": 0,
        "pointPrice": 0,
        "vipPrice": 0,
        "combinationRecordId": null,
        "items": [
            {
                "id": 220,
                "orderId": 225,
                "spuId": 640,
                "spuName": "商城测试商品",
                "skuId": 33,
                "properties": [
                    { "propertyId": 1, "propertyName": "颜色", "valueId": 6, "valueName": "蓝色" },
                    { "propertyId": 16, "propertyName": "重量", "valueId": 30, "valueName": "大" }
                ],
                "picUrl": "http://test.yudao.iocoder.cn/9c6f8897bf5b3baa457b056cdfd3edebb4c5def6b2f241267b5d6903606358af.png",
                "count": 2,
                "commentStatus": false,
                "price": 200,
                "payPrice": 400,
                "afterSaleId": null,
                "afterSaleStatus": 0
            }
        ]
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
id	Number	订单编号
no	Number	订单流水号
type	Number	订单类型0-普通订单 1-秒杀订单 2-砍价订单 3-拼团订单 4-积分商城
status	Number	订单状态0-待支付 10-待发货 20-已发货 30-已完成 40-已取消
productCount	Number	购买的商品数量
commentStatus	boolean	是否评价
createTime	String	订单创建时间
userRemark	String	用户备注
payStatus	boolean	是否已支付
payOrderId	Number	支付订单编号
payTime	String	付款时间
payExpireTime	String	付款超时时间
payChannelCode	String	支付渠道编码
totalPrice	Number	商品原价（总）
discountPrice	Number	订单优惠（总）
deliveryPrice	Number	运费金额，单位：分
adjustPrice	Number	订单调价（总）
payPrice	Number	应付金额，单位：分
deliveryType	Number	配送方式1-快递
logisticsId	Number	发货物流公司编号
logisticsName	String	发货物流名称
logisticsNo	String	发货物流单号
deliveryTime	String	发货时间
receiveTime	String	收货时间
receiverName	String	收件人名称
receiverMobile	String	收件人手机
receiverAreaId	Number	收件人地区编号
receiverAreaName	String	收件人地区名字
receiverDetailAddress	String	收件人详细地址
refundStatus	Number	售后状态 0-未退款 10-部分退款 20-全部退款
refundPrice	Number	退款金额，单位：分
couponPrice	Number	优惠劵减免金额
pointPrice	Number	积分抵扣的金额
vipPrice	Number	VIP 减免金额
combinationRecordId	Number	拼团记录编号
items	数组	订单商品项

取消订单

URL：/app-api/trade/order/cancel
Method：POST
需要鉴权：是

请求参数

参数	类型	是否必传	约束
id	Number	是	交易订单编号

请求示例

{ "id": 1 }

响应示例

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

响应说明

参数	类型	约束
data	boolean	true 成功
msg	String	非200提示错误信息

删除订单

URL：/app-api/trade/order/delete
Method：POST
需要鉴权：是

请求参数

参数	类型	是否必传	约束
id	Number	是	交易订单编号

请求示例

{ "id": 225 }

响应示例

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

响应说明

参数	类型	约束
data	boolean	true 成功
msg	String	非200提示错误信息

获取交易订单的物流轨迹

URL：/app-api/trade/order/getOrderExpressTrackList
Method：POST
需要鉴权：是

请求参数

参数	类型	是否必传	约束
id	Number	是	交易订单编号

请求示例

{ "id": 226 }

响应示例

{
    "code": 0,
    "data": {
        "name": "物流公司名称",
        "code": "物流公司code",
        "logisticsNo": "快递编号",
        "logo": "logo地址",
        "expressTrackRespDTOList": [
            { "time": 1677777, "content": "发生内容" }
        ]
    },
    "msg": ""
}

响应说明

参数	类型	说明
name	String	物流公司名称
code	String	物流公司编号
logisticsNo	String	物流单号
logo	String	logo
expressTrackRespDTOList		物流轨迹
content	String	快递状态
time	Long	发生事件，按时间排序，近的在前

获取交易订单的订单项

URL：/app-api/trade/order/item/get
Method：POST
需要鉴权：是

请求参数

参数	类型	是否必传	约束
id	Number	是	订单项数据编号对应订单详情中返回的items.id字段

请求示例

{ "id": 226 }

响应示例

{
    "code": 0,
    "data": {
        "id": 222,
        "orderId": 226,
        "spuId": 640,
        "spuName": "商城测试商品",
        "skuId": 33,
        "properties": [
            { "propertyId": 1, "propertyName": "颜色", "valueId": 6, "valueName": "蓝色" },
            { "propertyId": 16, "propertyName": "重量", "valueId": 30, "valueName": "大" }
        ],
        "picUrl": "http://test.yudao.iocoder.cn/9c6f8897bf5b3baa457b056cdfd3edebb4c5def6b2f241267b5d6903606358af.png",
        "count": 2,
        "commentStatus": false,
        "price": 200,
        "payPrice": 400,
        "afterSaleId": null,
        "afterSaleStatus": 0
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
id	Number	编号
orderId	Number	订单编号
spuId	Number	商品 SPU 编号
spuName	String	商品 SPU 名称
skuId	Number	商品 SKU 编号
picUrl	String	商品图片
count	Number	购买数量
commentStatus	boolean	是否评价
price	Number	商品原价（单）
payPrice	Number	应付金额（总），单位：分
afterSaleId	Number	售后编号
afterSaleStatus	Number	售后状态
properties	数组	商品属性值的明细

创建订单项的评价

说明

订单必须是已完成（待评价）状态。

URL：/app-api/trade/order/item/createOrderItemComment
Method：POST
需要鉴权：是

请求参数

参数	类型	是否必传	约束
anonymous	boolean	是	是否匿名true-匿名 false-不匿名
orderItemId	Number	是	订单项（商品项sku）数据编号
descriptionScores	Number	是	描述星级 1-5 分只能整数
benefitScores	Number	是	服务星级 1-5 分只能整数
content	String	是	评价内容
picUrls	数组	否	图片，最多9张

请求示例

{
  "anonymous": true,
  "orderItemId": 230,
  "descriptionScores": 5,
  "benefitScores": 5,
  "content": "评论内容",
  "picUrls": ["url", "url2"]
}

响应示例

{ "code": 0, "data": 15, "msg": "成功" }

响应说明

参数	类型	说明
msg	String	返回提示
data	Number	评论数据编号

获取商品的评价列表+我的评价

URL：/app-api/product/comment/getCommentPage
Method：POST
需要鉴权：是

请求参数

参数	类型	约束
spuId	Long	商品spuId非必传
userId	Long	用户数据编号，获取我的评价时，必传
type	Long	类型，默认传0（0全部、1好评、2中评、3差评）必传
pageNo	Long	页码
pageSize	Long	页大小，默认10，传-1不分页

请求示例

{ "spuId": 691, "type": 0, "pageNo": 1, "pageSize": 10 }

响应示例

{
    "code": 0,
    "data": {
        "list": [
            {
                "userId": 305,
                "userNickname": "匿名用户",
                "userAvatar": "https://oss.kudi.wiki/onps-test/logo.png",
                "id": 15,
                "anonymous": true,
                "orderId": 230,
                "orderItemId": 230,
                "replyStatus": true,
                "replyUserId": 1,
                "replyContent": "谢谢好评，商品就是不错！",
                "replyTime": 1733139122000,
                "additionalContent": null,
                "additionalPicUrls": null,
                "additionalTime": null,
                "createTime": 1733138177000,
                "spuId": 640,
                "spuName": "商城测试商品",
                "skuId": 33,
                "skuPicUrl": "https://jingqihui.oss-cn-beijing.aliyuncs.com/logo.jpg",
                "skuProperties": [
                    { "propertyId": 1, "propertyName": "颜色", "valueId": 6, "valueName": "蓝色" },
                    { "propertyId": 16, "propertyName": "重量", "valueId": 30, "valueName": "大" }
                ],
                "scores": 5,
                "descriptionScores": 5,
                "benefitScores": 5,
                "content": "评论内容",
                "picUrls": ["url", "url2"]
            }
        ],
        "total": 1
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
id	Long	评论数据编号
userId	Long	用户编号
userNickname	String	昵称
userAvatar	String	头像
anonymous	Boolean	是否匿名
orderId	Long	交易订单编号
orderItemId	Long	交易订单项编号
replyStatus	Boolean	商家是否回复
replyUserId	Long	回复的用户编号
replyContent	String	回复内容
replyTime	Long	回复时间
additionalContent	String	追加评论内容
additionalPicUrls	数组	追加评论图片
additionalTime	Long	追加评论时间
spuId	Long	商品spuId
spuName	String	商品名称
skuId	Long	商品skuId
skuPicUrl	String	商品sku图片
skuProperties	对象	sku属性
scores	Long	评分
descriptionScores	Long	商品描述评分
benefitScores	Long	服务评分
content	String	评论内容
picUrls	Array	评论图片
createTime	Long	评论时间

评价不可见

URL：/app-api/product/comment/update-visible
Method：POST
需要鉴权：是

请求参数

参数	类型	约束
id	Long	评论数据编号
visible	Long	评论是否可见true：可见 false：不可见

请求示例

{ "id": 15, "visible": true }

响应示例

{ "code": 0, "data": true, "msg": "成功" }

响应说明

参数	类型	说明
data	Boolean	`true` 成功，`false` 失败

获取物流公司列表

URL：/app-api/trade/delivery/express/getDeliveryExpressList
Method：GET
需要鉴权：是

请求参数

无参数。

请求示例

GET /app-api/trade/delivery/express/getDeliveryExpressList

响应示例

{
    "code": 0,
    "data": [
        { "id": 1, "code": "STO", "name": "申通快递", "logo": "http://...", "sort": 1, "status": 0 },
        { "id": 2, "code": "SF", "name": "顺丰速运", "logo": "http://...", "sort": 2, "status": 0 },
        { "id": 3, "code": "ZTO", "name": "中通快递", "logo": "http://...", "sort": 3, "status": 0 },
        { "id": 4, "code": "YD", "name": "韵达快递", "logo": "http://...", "sort": 4, "status": 0 }
    ],
    "msg": "成功"
}

响应说明

参数	类型	说明
id	Long	数据编号
code	String	快递公司编号
name	String	快递公司名称
logo	String	logo图片地址
sort	Long	排序
status	Long	状态0-正常 1-禁用

获取交易配置

URL：/app-api/trade/config/get
Method：GET
需要鉴权：否

请求参数

无请求参数。

请求示例

GET /app-api/trade/config/get

响应示例

{
    "code": 0,
    "data": {
        "afterSaleRefundReasons": ["不喜欢/不想要", "拍错/多拍", "商品与描述不符"],
        "afterSaleReturnReasons": ["质量问题", "发错货", "物流损坏"]
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
afterSaleRefundReasons	String[]	售后退款原因列表
afterSaleReturnReasons	String[]	售后退货原因列表

用户名密码登录​

请求参数​

请求示例​

响应示例​

响应说明​

创建订单前-订单结算信息​

请求参数​

请求示例​

响应示例​

响应说明​

下单前校验-是否可以下单​

请求参数​

请求示例​

响应示例​

响应说明​

创建订单​

请求参数​

请求示例​

响应示例​

响应说明​

获取订单分页​

请求参数​

请求示例​

响应示例​

响应说明​

获取订单详情​

请求参数​

请求示例​

响应示例​

响应说明​

取消订单​

请求参数​

请求示例​

响应示例​

响应说明​

删除订单​

请求参数​

请求示例​

响应示例​

响应说明​

获取交易订单的物流轨迹​

请求参数​

请求示例​

响应示例​

响应说明​

获取交易订单的订单项​

请求参数​

请求示例​

响应示例​

响应说明​

创建订单项的评价​

请求参数​

请求示例​

响应示例​

响应说明​

获取商品的评价列表+我的评价​

请求参数​

请求示例​

响应示例​

响应说明​

评价不可见​

请求参数​

请求示例​

响应示例​

响应说明​

获取物流公司列表​

请求参数​

请求示例​

响应示例​

响应说明​

获取交易配置​

请求参数​

请求示例​

响应示例​

响应说明​

用户名密码登录

请求参数

请求示例

响应示例

响应说明

创建订单前-订单结算信息

请求参数

请求示例

响应示例

响应说明

下单前校验-是否可以下单

请求参数

请求示例

响应示例

响应说明

创建订单

请求参数

请求示例

响应示例

响应说明

获取订单分页

请求参数

请求示例

响应示例

响应说明

获取订单详情

请求参数

请求示例

响应示例

响应说明

取消订单

请求参数

请求示例

响应示例

响应说明

删除订单

请求参数

请求示例

响应示例

响应说明

获取交易订单的物流轨迹

请求参数

请求示例

响应示例

响应说明

获取交易订单的订单项

请求参数

请求示例

响应示例

响应说明

创建订单项的评价

请求参数

请求示例

响应示例

响应说明

获取商品的评价列表+我的评价

请求参数

请求示例

响应示例

响应说明

评价不可见

请求参数

请求示例

响应示例

响应说明

获取物流公司列表

请求参数

请求示例

响应示例

响应说明

获取交易配置

请求参数

请求示例

响应示例

响应说明