api接口

API接口对接

域名

测试环境	正式环境
xxxx

返回说明

字段	类型	必选	说明
msg	String	是	状态说明
status	Bool	是	true成功,false失败
data	Array	是	返回数据

↓ 以下接口需要在header头添加token字段

字段	类型	必选	说明
token	String	是	认证id

token => 1

创建回收订单

URl

/api/dlOrder/create_order

请求参数

字段	类型	必选	说明
order_id	String	是	订单号不能重复
book_num	String	是	回收书籍区间(5-20本,20-35本,35-50本,50本以上)
pick_time	Datetime	是	预约上门时间 格式 yyyy-MM-dd HH:mm:ss
real_name	String	是	联系人
user_phone	String	是	手机号
user_address	String	是	江苏省,苏州市,吴中区,某某街道地址(用英文逗号分割,严格按照顺序)
address_str	String	是	320000,320500,320506(中间逗号分割,江苏省,苏州市,吴中区)
senderRemark	String	否	用户备注

返回数据

成功
{
    "msg": "下单成功!",
    "data": "",
    "status": true
}
失败
{
    "msg": "下单失败,错误原因:xxx",
    "data": "",
    "status": false
}

查看物流信息

URL

/api/dlOrder/search_info

请求参数

字段	类型	必选	说明
order_id	String	是	订单号
sort	Num	否	按订单状态排序 1正序,2倒序
limit	Num	否	拿几条数据,默认5条

返回数据

{
    "msg": "获取成功!",
    "data": {
        "order_id": "wx123113123",
        "book_num": "5-20本",
        "pick_time": "2021-10-15 13:16:00",
        "add_time": "2021-10-19 08:52:47",
        "weight": 0,
        "companyName": null,
        "deliveryNumber": null,
        "senderRemark": "用户备注",
        "log":  [
            "id": 24,
            "oid": "yzs163152661678",
            "add_time": "2021-09-13 17:50:16",
            "msg": "下单成功",
            "status": 0
        	]
        }
    },
    "status": true
}

返回数据说明

字段	说明
order_id	订单号
book_num	预约本数
pick_time	预约时间
weight	重量
companyName	快递名称
deliveryNumber	快递单号

Log说明

data中的log(array)是所有物流状态信息
其中status订单状态字段

状态码	状态	说明
1	已受理	平台已接收订单
2	待取件	快递公司接收订单并等待快递小哥上门取件
3	已取件	快递小哥已上门取件,这里会返回订单号和快递名称
4	已完成	订单完成 ,这里会返回快递重量
5	已取消	接入方调用接口或联系匠心客服主动取消或快递公司异常取消订单
0	下单成功	下单

取消订单

URL

/api/dlOrder/off_order

字段	类型	必选	说明
order_id	String	是	订单号

返回数据

失败
{"msg":"订单无法取消!","data":"","status":false}
成功
{"msg":"订单取消成功!","data":"","status":true}