Token接口


检测Token是否过期
Headers
名称 类型 必选 描述
token string 请求的Token,注:token值请放在headers
参数
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回成功
time string 响应的时间戳
data object 返回业务数据合集
token string token值
expires_in int token剩余时间,单位秒
{"code": 1,"msg": "","time": "1540347545","data": {"token": "8cxxx-4510-458f-a642-xxx","expires_in": 77759987}}
重新获取token值。刷新后原token将失效
Headers
名称 类型 必选 描述
token string 请求的原Token,注:token值请放在headers
参数
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回成功
time string 响应的时间戳
data object 返回业务数据合集
token string token值
expires_in int token剩余时间,单位秒
{"code": 1,"msg": "","time": "1540347545","data": {"token": "8cxxx-4510-458f-a642-xxx","expires_in": 77759987}}

礼品接口


获取在售礼品列表
Headers
名称 类型 必选 描述
token string 请求的Token,注:token值请放在headers
参数
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回成功
time string 响应的时间戳
data object 返回业务数据合集
goodslist string 商品列表。id:商品编码,name:商品名称,price:价格
{"code": 1,"msg": "返回成功","time": "1540347545","data": {"goodslist":[{"id":1,"name":"1.5米裁缝尺","price":"0.45"},{"id":2,"name":"8层加棉抹布","price":"0.90"}]}}
获取发货仓库列表
Headers
名称 类型 必选 描述
token string 请求的Token,注:token值请放在headers
参数
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回成功
time string 响应的时间戳
data object 返回业务数据合集
storelist string 仓库列表合集。id:仓库编码,store_name:仓库名称
{"code": 1,"msg": "返回成功","time": "1540347545","data": {"storelist":[{"id":1,"store_name":"圆通北京仓"},{"id":4,"store_name":"圆通广州仓"}]}}
礼品下单接口
Headers
名称 类型 必选 描述
token string 请求的Token,注:token值请放在headers
参数
名称 类型 必选 描述
send_order_no string 订单号,不可重复。
goodsid int 礼品编号,请在礼品列表接口获得具体编号
storesid int 仓库编号,请在仓库列表接口获得具体编号
plattype int 单号类型 默认 1,1是菜鸟,2是拼多多(请注意识别仓库支持单号类型)
receiver_name int 收货人
receiver_phone string 收货人号码
receiver_province string 收货地址所在省
receiver_city string 收货地址所在市
receiver_district string 收货地址所在区
receiver_address string 收货地址
sendname string 发件人
sendphone string 发件号码
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回说明
time string 响应的时间戳
data object 返回业务数据合集
express_no string 快递单号。由于人工打单,单号大约10分钟后上传到平台,请用获取单号接口查看
taskid int 单号ID,请保存
p Double 扣费金额
{"code": 1,"msg": "提交成功","time": "1540347545","data": {"express_no": "0","taskid": "98736","p": "3.0"}}
礼品批量下单接口
Headers
名称 类型 必选 描述
token string 请求的Token,注:token值请放在headers
参数
名称 类型 必选 描述
goodsid int 礼品编号,请在礼品列表接口获得具体编号
storesid int 仓库编号,请在仓库列表接口获得具体编号
format string orders参数数据格式,可选值json 为空是数组格式
plattype int 单号类型 默认 1,1是菜鸟,2是拼多多(请注意识别仓库支持单号类型)
orders object orders数据内容,以下是orders包含的参数
send_order_no string 订单号,不可重复。
receiver_name string 收货人
receiver_phone string 收货人号码
receiver_province string 收货地址所在省
receiver_city string 收货地址所在市
receiver_district string 收货地址所在区
receiver_address string 收货地址
sendname string 发件人
sendphone string 发件号码
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回说明
time string 响应的时间戳
data object 返回业务数据合集
okarr object 提交成功数据
errarr object 提交失败数据
{"code": 1,"msg": "提交成功","time": "1540347545","data": {"okarr": [{"send_order_no":"201909878789","taskid":"123","p":"2"}],"errarr": [{"send_order_no":"201909878789","msg":"订单号已经存在"}]}}
获取快递单号
Headers
名称 类型 必选 描述
token string 请求的Token,注:token值请放在headers
参数
名称 类型 必选 描述
taskid int 单号ID,下单时候返回的taskid
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回成功
time string 响应的时间戳
data object 返回业务数据合集
{"code": 1,"msg": "获取单号成功","time": "1540347545","data": {"express_no": "82081082712","taskid": "98736"}}
未返回单号订单,可以用此接口再次获取单号
Headers
名称 类型 必选 描述
token string 请求的Token,注:token值请放在headers
参数
名称 类型 必选 描述
taskids int 单号ID,下单时候返回的taskid,多个单号请用逗号(,)分开
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回成功
time string 响应的时间戳
data object 返回业务数据合集
{"code": 1,"msg": "查询成功","time": "1540347545","data": {"okarr": [{"express_no":"88888","taskid":"123","msg":"单号获取成功"}],"errarr": [{"express_no":"0","taskid":"234","msg":"单号待获取"}]}}
未出单号的订单,可以用此接口取消订单并退款
Headers
名称 类型 必选 描述
token string '请求的Token'
参数
名称 类型 必选 描述
tid int 单号id,就是下单成功后返回的taskid字段
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回说明
time string 响应的时间戳
data object 返回业务数据合集
p decimal 退款金额
tid int 任务id
{"code": 1,"msg": "取消成功","time": "1540347545","data": {"p": "3.2","taskid":"88888"}}
获取账号余额
Headers
名称 类型 必选 描述
token string 请求的Token,注:token值请放在headers
参数
正文
Headers
参数
响应输出

                                                            

                                                        
返回参数
名称 类型 描述
code integer 状态值:1 为成功
msg string 返回成功
time string 响应的时间戳
data object 返回业务数据合集
usermoney string 账号所剩余额
{"code": 1,"msg": "","time": "1540347545","data": {"usermoney":88.88}}