游牧商城API文档 By Api-Doc-PHP

线上交易类

API - 获取运费(预下单/报错此规格就无法下单)

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/freightorder

请求参数

参数	类型	描述	默认值	是否必须
gid	number	产品规格的id	空	必须
num	number	购买数量	空	必须
address_id	number	收货地址id	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 下订单

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/addorder

请求参数

参数	类型	描述	默认值	是否必须
id	number	产品id	空	必须
gid	number	产品规格的id	空	必须
hxd_id	number	产品hxd_id	空	必须
hxd_gid	number	产品规格的hxd_gid	空	必须
num	number	购买数量	空	必须
cloud_id	number	云店id非必传	空	非必须
address_id	number	收货地址id	空	必须
msg	string	备注	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 订单支付最大使用金额计算

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/orderfun

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 支付订单

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/palayorder

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	必须
price	number	现金支付金额	0	非必须
ye	number	余额支付金额	0	非必须
dkq	number	绿宝支付金额	0	非必须
yhq	number	提货卷支付金额	0	非必须
code	string	小程序	wx.login	临时登录码（有值则按小程序换openid并走JSAPI）
auth_code	string	公众号网页授权code（有值则按公众号OAuth换openid并走JSAPI，优先级高于code）	无	非必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 微信支付结果查询并确认订单

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/wxpayquery

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	必须

API - 微信支付异步通知（APIv3：验签、解密

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/wxpaynotify

API - 取消订单

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/cancelorder

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 申请退款、取消退款申请

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/refundorder

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	必须
state	number	类型值为afr申请退款为nafr取消申请	0	非必须
msg	number	退款原因	申请退款时必填	0

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 确认收货

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/receiptorder

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 添加收藏

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/collectadd

请求参数

参数	类型	描述	默认值	是否必须
token	string	token	无	必须
type	string	类型shop-店铺、goods-产品	无	必须
id	string	店铺、产品id	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

API - 删除收藏

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/collectdel

请求参数

参数	类型	描述	默认值	是否必须
token	string	token	无	必须
id	string	数据id	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

API - 收藏列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Cloud_goods/collectlist

请求参数

参数	类型	描述	默认值	是否必须
name	string	名称搜索	无	非必须
type	string	类型	无	非必须
sid	string	收藏产品、店id	无	非必须
page	string	页数20条固定	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

数据凭证类

API - 按消费金额配送等额数据凭证

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/DataVoucher/createByConsume

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须
amount	number	消费金额	空	必须（大于0）

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 获取用户数据凭证列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/DataVoucher/list

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 获取用户绿宝和提货券余额

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/DataVoucher/balance

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 绿宝转账

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/DataVoucher/transfer

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须
to_phone	string	接收人手机号	空	必须
amount	number	转账金额	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 绿宝质押变现申请（提交后台审核）

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/DataVoucher/pledgeApply

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须
amount	number	质押绿宝数量	空	必须
type	int	变现类型	1银行卡	2微信
real_name	string	姓名/开户名	空	必须
card_no	string	银行卡号	空	type=1时必须
bank_branch	string	开户分行	空	type=1时必须
card_img	string	银行卡图片路径	空	type=1时必须（先上传图片后传路径）
qrcode_img	string	收款码图片路径	空	type=2或3时必须（先上传图片后传路径）

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 用户绿宝质押申请记录列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/DataVoucher/pledgeApplyRecordList

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须
status	int	状态	0待审核	1通过
page	int	页码	空	可选
limit	int	每页数量	空	可选

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 绿宝抽奖

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/DataVoucher/lottery

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 当日剩余抽奖次数

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/DataVoucher/lottery_remaining

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须

返回参数

参数	类型	描述
remaining	int	当日还可抽奖次数
used_today	int	当日已抽次数
limit_daily	int	每日上限（与

状态码说明

状态码	描述
0	成功

API - 获取产出记录

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/DataVoucher/outputRecord

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须
type	number	类型	1:绿宝	2:提货券
page	number	页码	空	可选
limit	number	每页数量	空	可选

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

模式Ⅰ类

API - 赠送记录

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Model_Shop/zzlist

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
page	int	页数	无	非必须
limit	int	每页条数	无	必须
zhi	int	类型-1出1入	无	必须
type	int	类型筛选	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 赠送余额（弹窗显示金额对方信息二次确认）

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Model_Shop/hz1

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
num	number	数量	无	必须
phone	number	对方人手机号（下级、东家）	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 余额充值记录

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Model_Shop/palaylist

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
page	int	页数	无	必须
limit	int	每页条数	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 提交凭证充值余额

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Model_Shop/palay_img

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
img	string	图片url	无	必须
num	number	金额数量	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

订单类

API - 订单(所有数据)列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Order/orderlist

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	非必须
page	number	页数条数固定20	0	必须
state	number	状态0-待支付1-已支付2-已完成3-已退款-1订单取消4-待收货、不传全部订单	0	非必须
type	number	类型1-线下普通订单2-线下即使零售订单3-线上普通订单4-线上模式订单、不传全部订单	0	非必须
name	string	订单搜索云店名、产品名	0	非必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 订单各个状态数量

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Order/ordernum

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	非必须
page	number	页数条数固定20	0	必须
type	number	类型1-线下普通订单2-线下即使零售订单3-线上普通订单4-线上模式订单、不传全部订单	0	非必须
name	string	订单搜索云店名、产品名	0	非必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 店铺订单(所有数据)列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Order/cloudorderlist

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	非必须
page	number	页数条数固定20	0	必须
state	number	状态0-待支付1-已支付2-已完成3-已退款-1订单取消4-待收货、不传全部订单	0	非必须
type	number	类型1-线下普通订单2-线下即使零售订单3-线上普通订单4-线上模式订单、不传全部订单	0	非必须
name	string	订单搜索云店名、产品名	0	非必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 店铺订单各个状态数量

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Order/shopordernum

请求参数

参数	类型	描述	默认值	是否必须
id	number	订单id	空	非必须
page	number	页数条数固定20	0	必须
type	number	类型1-线下普通订单2-线下即使零售订单3-线上普通订单4-线上模式订单、不传全部订单	0	非必须
name	string	订单搜索云店名、产品名	0	非必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 查询物流

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Order/logisticsmsg

请求参数

参数	类型	描述	默认值	是否必须
gid	number	供应链产品订单id	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

线上公共类

API - 产品列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_cloud/Goodslist

请求参数

参数	类型	描述	默认值	是否必须
name	string	和供应链产品列表参数一致	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 产品详情

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_cloud/Goods

请求参数

参数	类型	描述	默认值	是否必须
name	string	和供应链产品列表参数一致	空	必须
hxd_id	string	产品数据的hxd_id	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 产品分类

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_cloud/GoodsType

请求参数

参数	类型	描述	默认值	是否必须
name	string	和供应链产品列表参数一致	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 专区列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_cloud/Goodsszlist

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 专区详情

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_cloud/sz

请求参数

参数	类型	描述	默认值	是否必须
id	string	专区id	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 专区产品列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_cloud/Goodssz

请求参数

参数	类型	描述	默认值	是否必须
id	string	专区id	空	必须
name	string	搜索	空	必须
order	string	desc\asc价格排序方式留空默认排序	空	必须
page	int	页数	空	必须
limit	int	每页条数	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 关于我们_图片列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_cloud/about_us_image

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
images	array	图片列表，每项含

状态码说明

状态码	描述
0	成功
其他	失败

API - 首页_轮播图列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_cloud/home_carousel_list

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
list	array	轮播列表（id、path、url、link_url、sort、created_at）

状态码说明

状态码	描述
0	成功

用户公共类

API - 密码登录

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_user/login_password

请求参数

参数	类型	描述	默认值	是否必须
phone	int	用户手机号	无	必须
password	string	登录密码	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

API - 获取验证码[找回登录密码]

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_user/zlogin_code

请求参数

参数	类型	描述	默认值	是否必须
phone	int	用户手机号	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

API - 找回登录密码

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_user/update_login

请求参数

参数	类型	描述	默认值	是否必须
phone	int	用户手机号	无	必须
code	int	验证码	无	必须
password	string	新登录密码	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

API - 微信小程序一键注册登录

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_user/reglogin

请求参数

参数	类型	描述	默认值	是否必须
pid	int	推荐人用户id	0	必须
token	string	令牌	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 获取验证码（与

请求方式：

请求地址：https://api.youmucheng.cn/index.php/api/Public_user/code

API - 获取验证码

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_user/codes

请求参数

参数	类型	描述	默认值	是否必须
phone	int	用户手机号	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

API - 验证码、注册/登录

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_user/getuser

请求参数

参数	类型	描述	默认值	是否必须
phone	int	用户手机号	无	必须
code	int	验证码	无	必须
pid	string	推荐人id	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

API - 获取数据token

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_user/getkeytoken

请求参数

参数	类型	描述	默认值	是否必须
token	string	token	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

API - 根据id获取账户信息

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_user/getphone

请求参数

参数	类型	描述	默认值	是否必须
id	string	用户id	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
其他	失败

微信H5与JS-SDK

API - 微信JS-SDK权限验证签名wx.config

请求方式： GET|POST

请求地址：https://api.youmucheng.cn/index.php/api/Public_wechat/jssdk_config

请求参数

参数	类型	描述	默认值	是否必须
url	string	当前页完整URL不含hash与微信内打开一致	无	必须

返回参数

参数	类型	描述
code	int	0成功100失败
msg	string	提示文案
appId	string	wx.config的appId优先取wechat_official_h5否则回退wechat_mp_login
timestamp	string	Unix时间戳秒字符串
nonceStr	string	签名用随机串
signature	string	SHA1签名

状态码说明

状态码	描述
0	成功data内含appId、timestamp、nonceStr、signature供wx.config使用
100	失败如缺参、url非法、未配置appid、jsapi_ticket获取失败等见msg

用户类

API - 获取用户信息

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/msg

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data.pledge_setting_enabled	int	质押申请入口
data.pledge_record_enabled	int	质押记录入口

状态码说明

状态码	描述
0	成功
其他	失败

API - 修改头像

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/update_img

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
file	string	图片文件	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 修改登录密码

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/update_password

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
passwordy	number	原登录密码	无	否
password	number	新登录密码	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 绑定推荐人

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/bdtjr

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须
phone	string	推荐人手机账号	令牌	空

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 我的团队

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/team

请求参数

参数	类型	描述	默认值	是否必须
token	string	令牌	空	必须
page	number	页数	令牌	空

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 获取地址省市县列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/address_list

请求参数

参数	类型	描述	默认值	是否必须
type	string	几级1、2、3、4	空	必须
pid	string	上级id非一级必传	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 获取用户资金记录

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/jinbi_list

请求参数

参数	类型	描述	默认值	是否必须
type	string	类型	空	必须
msg	string	说明	空	必须
zhi	string	金额	空	必须
time_start	string	开始时间时间戳	空	必须
time_end	string	结束时间时间戳	空	必须
limit	number	条数	空	必须
page	number	页数	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 获取用户资金类型

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/jinbi_type

请求参数

参数	类型	描述	默认值	是否必须
type	string	类型	空	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息

状态码说明

状态码	描述
0	成功
其他	失败

API - 获取用户收货地址列表

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/address_list_user

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 添加收货地址

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/address_user_add

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
name	string	收货人	无	必须
phone	int	收货人手机号	无	必须
sex	string	性别（先生、女士）	无	必须
address1	int	省ID	无	必须
address2	int	市、区ID	无	必须
address3	int	县ID	无	非必须
address4	int	县ID	无	非必须
address	int	详细地址	无	必须
lon	int	经度	无	必须
lat	int	纬度	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 修改收货地址

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/address_user_update

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
id	string	收货地址数据ID	无	必须
name	string	收货人	无	必须
phone	int	收货人手机号	无	必须
sex	string	性别（先生、女士）	无	必须
address1	int	省ID	无	必须
address2	int	市、区ID	无	必须
address3	int	县ID	无	非必须
address4	int	县ID	无	非必须
address	int	详细地址	无	必须
lon	int	经度	无	必须
lat	int	纬度	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 删除收货地址

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/address_user_del

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
id	int	收货地址ID	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 设置收货地址默认

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/address_user_mo

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
id	int	收货地址ID	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败

API - 余额提现方式_列表（可多笔，其中一笔为默认）

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/balance_withdraw_setting_get

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须

状态码说明

状态码	描述
0	成功

API - 余额提现方式_新增或编辑

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/balance_withdraw_setting_save

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
id	int	编辑时传记录id，新增不传	无	非必须
is_default	int	传1设为默认	无	非必须（首条会自动默认）
type	int	1银行卡	2微信	3支付宝
real_name	string	姓名/开户名	无	必须
bank_name	string	开户银行	type=1	无
bank_branch	string	开户支行	type=1	无
bank_card	string	银行卡号	type=1	无
card_img	string	银行卡照片路径	type=1	无
qrcode_img	string	收款码路径	type=2或3	无

状态码说明

状态码	描述
0	成功

API - 余额提现方式_删除

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/balance_withdraw_setting_delete

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
id	int	设置记录id	无	必须

状态码说明

状态码	描述
0	成功

API - 余额提现申请

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/balance_withdraw_apply

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
num	string	提现金额	无	必须
setting_id	int	使用哪条提现方式，不传则用默认	无	非必须
remark	string	备注	无	非必须

状态码说明

状态码	描述
0	成功
其他	失败

API - 余额提现记录

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/balance_withdraw_record

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
page	int	页数	无	必须
limit	int	每页条数	无	必须
zt	int	状态筛选	0待审核	1已通过

状态码说明

状态码	描述
0	成功

API - 文件上传

请求方式： POST

请求地址：https://api.youmucheng.cn/index.php/api/User/upfile

请求参数

参数	类型	描述	默认值	是否必须
token	string	身份鉴权token	无	必须
file	file	上传的文件	无	必须

返回参数

参数	类型	描述
code	int	状态码（具体参见状态码说明）
msg	string	提示信息
data	array	数据

状态码说明

状态码	描述
0	成功
1023	未登录
其他	失败