1. 查询店铺
获取某用户的所有店铺列表
GET:http://api.xdua.com/shop
只有root才可以查看某个户群下的所有店铺
god只能看到自某个户群下的自己管辖范围的所有店铺。
| 字段名 | 位置 | 类型 | 字段说明 | 举例 | 可选 |
|---|---|---|---|---|---|
| apiv | head | string | API版本(默认是1.0.0) | 1.0.0 | 可选 |
| Authorization | head | string | 客户端保存的鉴权token | Authorization字符串 | 必选 |
| ugrp_id | query | string | 户群 | 户群的id | 必选 |
| page | query | int | 搜索页号 | page出现的时侯,忽略offset和limit一起表达第page页,有limit条记录 | 可选 |
| offset | query | int | 搜索开始的偏移条件 | 获取用店铺的开始个数，不设置默认为0 | 可选 |
| limit | query | int | 搜索数量 | 获取用店铺的数量，不设置默认为20 | 可选 |
| order | query | string | 顺序 | 必须按照"字段:ASC/DESC"方式书写，如 name:DESC | 可选 |
| filter | query | string | 过滤条件 | 以json字符串表达的搜索条件 | 可选 |
返回数据
成功返回
{
"error": 0,
"reason": "Success",
"result": {
"maxpage": 1,
"list": [{
"enabled": "1",
"invite_only": "0",
"rolec": "1",
"usroc": "0",
"code": "children",
"avatar": "http://xdua-files.oss-cn-qingdao.aliyuncs.com/Image/default.png",
"creator_id": "Dt5mvrtU",
"private": "0",
"id": "b15f96dd",
"cstamp": "2018-05-25 14:54:39",
"name": "儿研所",
"creator_name": "dua:辣椒帅",
"brief": "给儿研所项目创建的用店铺"
}, {
"enabled": "1",
"invite_only": "0",
"rolec": "2",
"usroc": "0",
"code": "wikicivi",
"avatar": "http://xdua-files.oss-cn-qingdao.aliyuncs.com/Image/default.png",
"creator_id": "Dt5mvrtU",
"private": "0",
"id": "83b1d782",
"cstamp": "2018-03-25 17:42:49",
"name": "无人阅读",
"creator_name": "dua:辣椒帅",
"brief": "wikcivi用店铺的根用户"
}, {
"enabled": "1",
"invite_only": "0",
"rolec": "0",
"usroc": "0",
"code": "calathus",
"avatar": "http://xdua-files.oss-cn-qingdao.aliyuncs.com/Image/default.png",
"creator_id": "Dt5mvrtU",
"private": "0",
"id": "c0d8f537",
"cstamp": "2018-03-25 17:50:05",
"name": "水果篮",
"creator_name": "dua:辣椒帅",
"brief": "faf"
}, {
"enabled": "0",
"invite_only": "0",
"rolec": "1",
"usroc": "0",
"code": "test",
"avatar": "",
"creator_id": "Dt5mvrtU",
"private": "0",
"id": "fbe261e0",
"cstamp": "2018-05-27 10:33:51",
"name": "测试",
"creator_name": "dua:辣椒帅",
"brief": "测试"
}]
},
}
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| id | string | 店铺的id |
| ugrp_id | string | 所在户id |
| ugrp_name | string | 所在户群名 |
| code | string | 店铺的代号 |
| name | string | 店铺名 |
| brief | string | 店铺说明 |
| avatar | string | 店铺的头像 |
| creator_id | string | 店铺创建者的id |
| creator_name | string | 店铺创建者的名字 |
| invite_only | int | 1:只接受邀请注册 0:接受主动注册 |
| private | int | 1:私有店铺 0:公开店铺。私有店铺不可以被搜索到。 |
| enabeld | int | 店铺的使能状态,1:打开 0:关闭. 关闭的店铺处于冻结状态,不接受登陆/注册所有操作. |
| cstamp | string | 创建的时间戳字符串 |
| ustamp | string | 更新的时间戳字符串 |
失败返回
{
"error": >0,
"reason": "失败原因",
"result": {"失败返回的参考数据"},
}