## 获取所有用户列表信息(userList)
>[info] 场景说明:获取商城用户列表信息,方便第三方平台(APP、小程序、ERP)建立用户关联数据,实现营
### 是否需要获取用户TOKEN
`否`
*****
### 请求地址
```
POST http://api.xxx.com/user/list
```
### 公共请求参数
| 字段 | 类型 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| appid | string | 必须 | 平台提供的唯一APPID |
| version | string | 必须 | 接口版本号,固定填:v3 |
| sign\_type | string | 必须 | 签名类型,目前只支持md5 |
| timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss |
| format | string | 必须 | 返回的数据格式,只支持json |
| sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) |
| token | string | 必须 | 访问TOKEN |
| params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 |
应用请求参数`params`格式
| 字段 | 类型 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| page | integer | 可选 | 当前页,默认第一页 |
| page\_size | integer | 可选 | 每一页显示多少数据,默认10条 |
### 请求示例
```
{
"appid": "您的APPID",
"version": "v3",
"sign_type": "md5",
"timestamp": "2020-8-10 12:00:00",
"format": "json",
"sign": "op0987yhjmngt54rtg2wgdfvcder2765",
"params": {
"page": 1,
"page_size": 10
}
}
```
*****
### 公共返回参数
| 字段 | 类型 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) |
| message | string | 必须 | 请求成功/失败的描述信息 |
| \+ data | array | 必须 | 返回结果,如果没有数据则返回空 |
| └ list | list | 必须 | 用户列表 |
| └ paginationn | array | 必须 | 分页信息 |
返回`data->list`参数格式
| 字段 | 类型 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| userid | integer | 必须 | 用户ID |
| username | string | 必须 | 用户名 |
| nickname | string | 必须 | 用户昵称 |
| email | string | 可选 | 用户电子邮箱 |
| phone\_mob | string | 必须 | 用户手机号 |
| portrait | string | 必须 | 用户头像 |
| money | decimal | 必须 | 用户金钱余额 |
| integral | integer | 必须 | 用户积分数 |
| gender | integer | 必须 | 用户性别,0=保密,1=男,2=女 |
| birthday | string | 可选 | 生日,格式:yyyy-mm-dd |
| im\_qq | string | 可选 | 用户QQ |
| last\_login | string | 可选 | 上次登录时间,格式:yyyy-mm-dd hh:ii::ss |
返回`data->pagination`参数格式
| 字段 | 类型 | 是否必填 | 描述 |
| --- | --- | --- | --- |
| page | integer | 必须 | 当前页 |
| page\_size | integer | 必须 | 每一页显示的数据量 |
| page\_count | integer | 必须 | 总页数 |
| total | integer | 必须 | 总记录数 |
### 返回数据示例
```
{
"code": 0,
"message": "成功",
"data": {
"list": [
{
"userid":1,
"username":"admin",
"nickname":"",
"email":"",
"gender":0,
"birthday":"",
"phone_mob":"18987654356",
"im_qq":"",
"portrait":"http://www.xxx.com/data/system/default_user_portrait.gif",
"last_login":"2020-08-20 10:01:26",
"integral":0,
"money":0
},
{
"userid":2,
"username":"seller",
"nickname":"",
"email":"",
"gender":0,
"birthday":"",
"phone_mob":"15987676543",
"im_qq":"",
"portrait":"http://www.xxx.com/data/system/default_user_portrait.gif",
"last_login":"2020-08-17 19:50:05",
"integral":0,
"money":2993
}
],
"pagination":{
"page":1,
"page_size":10,
"page_count":1,
"total":2
}
}
}
```
- 概述
- 签名与验签
- 签名规则
- 获取访问TOKEN
- 手机密码登录换取用户TOKEN
- 手机验证码登录换取用户TOKEN
- 微信登录换取用户TOKEN
- QQ登录换取用户TOKEN
- 用户API
- 获取用户列表
- 获取单条用户信息
- 更新用户信息
- 修改用户手机号
- 获取用户资产信息
- 修改资金账户支付密码
- 商品类目API
- 获取商品分类列表
- 获取单条商品分类信息
- 商品API
- 获取商品列表
- 搜索商品数据(多条件)
- 获取单条商品信息
- 获取商品描述信息
- 获取商品SKU列表
- 获取商品SKU单条信息
- 获取商品SKU价格信息
- 获取商品上下架信息
- 获取商品相册图片列表
- 获取商品相册单张图片信息
- 获取单个商品的属性集合信息
- 获取商品的默认物流配送资费
- 获取单个商品销售记录列表
- 获取单个商品评价记录列表
- 获取单个商品咨询记录列表
- 用户插入商品咨询
- 用户收藏商品/取消收藏
- 获取我收藏的商品列表
- 获取我收藏的商品的数量
- 品牌API
- 获取品牌列表
- 获取单条品牌信息
- 店铺类目API
- 获取店铺分类列表
- 获取单条店铺分类信息
- 店铺API
- 获取店铺列表
- 获取单条店铺信息
- 修改店铺信息
- 用户收藏店铺/取消收藏
- 获取店铺等级列表
- 获取单条店铺等级信息
- 获取我收藏的店铺列表
- 获取我收藏的店铺的数量
- 地区API
- 获取地区列表
- 获取单条地区信息
- 收货地址API
- 获取收货地址列表
- 获取单条收货地址信息
- 新增收货地址
- 更新收货地址信息
- 删除收货地址
- 购物车API
- 获取购物车商品数据
- 选择购物车商品结算
- 插入商品到购物车
- 更新购物车商品
- 移除购物车商品
- 删除整个购物车
- 订单API
- 获取单条订单信息
- 获取单条订单商品数据
- 获取单条订单收货人信息
- 获取单条订单物流跟踪信息
- 获取预提交订单数据集合
- 提交预支付购物订单
- 获取卖家管理的订单列表
- 获取卖家消息提醒数据
- 获取我的消息提醒数据
- 获取我购买的订单列表
- 插入我的订单评价
- 收银台API
- 获取预支付交易数据集合
- 提交预支付交易订单
- 交易API
- 获取交易记录列表
- 获取单条交易记录
- 获取收支记录列表
- 获取单条收支记录
- 余额提现至银行卡
- 支付宝微信等充值余额
- 获取银行卡列表
- 绑定提现银行卡
- 删除提现银行卡
- 获取银行卡数量
- 退款API
- 创建退款申请
- 查看退款记录
- 修改退款申请
- 取消退款申请
- 卖家同意退款申请
- 卖家拒绝退款申请
- 获取我的退款列表
- 获取卖家管理的退款列表
- 获取退款协商留言记录
- 提交退款协商留言
- 申请平台介入退款争议
- 优惠券API
- 获取可领取的优惠券
- 获取单条优惠券信息
- 用户点击领取优惠券
- 获取我的优惠券列表
- 获取我的优惠券数量
- 积分API
- 获取积分商品列表
- 获取积分用户列表
- 获取我的积分账户信息
- 获取我的积分记录列表
- 用户每日签到领积分
- 限时打折API
- 获取限时打折商品列表
- 获取单条限时打折商品信息
- 满减满折API
- 获取满减满折信息
- 满包邮API
- 获取满包邮信息
- 短信服务API
- 发送一条短信
- 图片上传API
- 上传一张图片
- 上传文件代码
- 公共状态码
- 支付方式代码
- 订单业务类型代码
- 银行代码表