一件事列表

接口说明

请求URL：http[s]://{网关地址}/coosk/v2/oneThings/query

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求头

字段名	参数名	必填	类型	描述
应用ID	appId	M	String(128)	接入网关的应用ID
Token	accessToken	M	String	接入网关的accessToken

请求体

字段名	参数名	必填	类型	描述
页码	pageNumber	O	int	页码
每页数量	pageSize	M	int	每页数量
是否启用	isEnable	M	int	是否启用(1启用 0不启用) 默认为1
多语言	language	M	String(50)	多语言 （zh_CN,en,ru）不填写默认为中文
用户账号	userAccount	M	String(20)	用户账号，不填写默认为游客
用户账号所属范围	objectScope	M	int	用户账号所属范围 1:校内 2:校外

请求示例

{
  "pageNumber": 1,
  "pageSize": 10,
  "langCountry": "zh_cn",
  "isEnable":1
}

响应说明

响应体

字段名	参数名	类型	描述
分页大小	pageSize	int	一次返回记录的总条数
第几页	pageNumber	int	查询数据的位置
总数	totalSize	int	总数
返回码	errcode	String	0 成功，其他为不成功
返回码描述	errmsg	String	返回码描述
返回对象	datas	OneThingInfo	一件事具体信息

一件事具体信息OneThingInfo(返回)

参数	类型	描述
wid	string	一件事主键
oneThingName	string	一件事名字
oneThingDescription	string	一件事描述
oneThingServeObj	SimpleObj	一件事服务对象
oneThingServeCategory	SimpleObj	一件事分类
oneThingBusiness	OneThingBusiness	一件事业务周期
isEnable	int	是否启用(1启用 0不启用)
iconUrl	String	一件事图标

SimpleObj(返回)

参数	类型	描述
wid	string	主键
name	string	名字

OneThingBusiness(返回)

参数	类型	描述
businessType	int	-1:永久 0:不重复 1:每月重复 2:按每年的几月几号
startTime	string	当为0时 返回的是yyyy-mm-dd的具体时间 当为1时 返回的是具体日 当为2时 返回的是具体的月日
endTime	String	当为0时 返回的是yyyy-mm-dd的具体时间 当为1时 返回的是具体日 当为2时 返回的是具体的月日

响应示例

{
    "pageNumber": 1,
    "pageSize": 10,
    "totalSize": 5,
    "errcode": "0",
    "errmsg": "success",
    "traceId": null,
    "datas": [
        {
            "wid": "1009137166875103232",
            "oneThingName": "name",
            "oneThingDescription": "desc",
            "oneThingServeObj": [
                {
                    "wid": "3",
                    "name": "游客"
                }
            ],
            "oneThingServeCategory": [
                {
                    "wid": "rewards_punishments",
                    "name": "奖惩类"
                }
            ],
            "oneThingBusiness": {
                "businessType": -1,
                "startTime": null,
                "endTime": null
            },
            "isEnable": 1,
            "iconUrl": null
        },
        {
            "wid": "1004790099654479872",
            "oneThingName": "一盒事情",
            "oneThingDescription": "都睡到",
            "oneThingServeObj": [
                {
                    "wid": "3",
                    "name": "游客"
                }
            ],
            "oneThingServeCategory": [
                {
                    "wid": "support_subject",
                    "name": "资助类"
                }
            ],
            "oneThingBusiness": {
                "businessType": 0,
                "startTime": "2022-08-16",
                "endTime": "2022-09-22"
            },
            "isEnable": 1,
            "iconUrl": null
        },
        {
            "wid": "1004782034867720192",
            "oneThingName": "一件事测试wr",
            "oneThingDescription": "为",
            "oneThingServeObj": [
                {
                    "wid": "3",
                    "name": "游客"
                }
            ],
            "oneThingServeCategory": [
                {
                    "wid": "employment_subject",
                    "name": "就业类"
                }
            ],
            "oneThingBusiness": {
                "businessType": -1,
                "startTime": null,
                "endTime": null
            },
            "isEnable": 1,
            "iconUrl": null
        }
    ]
}

错误码

错误码	描述
999	统一错误码，详细描述信息参见接口返回

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID,APP_SECRET);
// 创建请求对象
OneThingsQueryRequest request = new OneThingsQueryRequest();
OneThingsQueryResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
//.....
}