1. 查询商品
获取某用户的所有商品列表
GET:http://api.xdua.com/good
只有root才可以查看某个户群下的所有商品
god只能看到自某个户群下的自己管辖范围的所有商品。
| 字段名 | 位置 | 类型 | 字段说明 | 举例 | 可选 |
|---|---|---|---|---|---|
| apiv | head | string | API版本(默认是1.0.0) | 1.0.0 | 可选 |
| Authorization | head | string | 客户端保存的鉴权token | Authorization字符串 | 必选 |
| ugrp_id | query | string | 户群 | 户群的id | 必选 |
| uid | query | int | 用户m5d(精确搜索) | 获取那个用户的商品，如果没有说明，就是所有用户 | 可选 |
| name | query | string | 商品名(模糊搜索） | 获取某用户的所有商品，在sql级以like %name%方式查询,(下划线例外) | 可选 |
| brief | query | string | 商品说明(模糊搜索) | 获取相关说明的所有用商品，在sql级以like %brief%方式查询 | 可选 |
| page | query | int | 搜索页号 | page出现的时侯,忽略offset和limit一起表达第page页,有limit条记录 | 可选 |
| offset | query | int | 搜索开始的偏移条件 | 获取用商品的开始个数，不设置默认为0 | 可选 |
| limit | query | int | 搜索数量 | 获取用商品的数量，不设置默认为20 | 可选 |
| order | query | string | 顺序 | 必须按照"字段:ASC/DESC"方式书写，如 name:DESC | 可选 |
返回数据
成功返回
{
"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": {"失败返回的参考数据"},
}