一件事详情

接口说明

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

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求头

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

请求体

字段名	参数名	必填	类型	描述
多语言	language	M	String(50)	多语言 （zh_CN,en,ru）不填写默认为中文
一件事主键	wid	M	String(64)	一件事主键

请求示例

{
  "wid":"1007215122318221312"
}

响应说明

响应体

字段名	参数名	类型	描述
返回码	errcode	String	0 成功，其他为不成功
返回码描述	errmsg	String	返回码描述
返回对象	datas	OneThingDetailInfo	一件事详情信息

一件事详情信息OneThingDetailInfo(返回)

参数	类型	描述
fieldsAndValues	List<FieldsAndValue>	一件事字段和值对象
servicesAndItems	List<ServicesAndItem>	一件事关联服务和事项
isEnabled	int	0停用 1启用

FieldsAndValue(返回)

参数	类型	描述
field	Field	字段
value	Value	值
isEnabled	int	0停用 1启用

ServicesAndItem(返回)

参数	类型	描述
wid	string	服务或者事项主键
objType	int	0：服务 1：事项
name	string	服务或者事项名字
sortNum	int	排序号

Field(返回)

参数	类型	描述
wid	string	字段wid
columnName	string	字段名字
formType	int	字段类型 1：单行文本 2：多行文本 3：下拉单选 4：下拉多选 5：富文本 6：附件 7：多行文本+附件 8：富文本+附件 9：特殊

Value(返回)

参数	类型	描述
columnId	string	字段wid
columnValue	Object	值
attachments	List<Attachments>	附件
questionAndAnswer	List<QuestionAndAnswer>	问题
oneThingBusiness	List<OneThingBusiness>	一件事业务周期

Attachments(返回)

参数	类型	描述
fileName	string	文件名字
fileUrl	string	文件地址

QuestionAndAnswer(返回)

参数	类型	描述
question	string	问题
answer	string	答案

OneThingBusiness(返回)

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

响应示例

{
    "errcode": "0",
    "errmsg": "success",
    "traceId": null,
    "datas": {
        "fieldsAndValues": [
            {
                "field": {
                    "columnName": "一件事图标",
                    "wid": "ONE_THING_ICON",
                    "formType": 9
                },
                "value": []
            },
            {
                "field": {
                    "columnName": "测试2",
                    "wid": "991351212287410176",
                    "formType": 4
                },
                "value": [
                    {
                        "columnId": "991351212287410176",
                        "columnValue": null,
                        "attachments": [],
                        "questionAndAnswer": [],
                        "oneThingBusiness": null
                    }
                ]
            },
            {
                "field": {
                    "columnName": "一件事名称",
                    "wid": "ONE_THING_NAME",
                    "formType": 1
                },
                "value": [
                    {
                        "columnId": "ONE_THING_NAME",
                        "columnValue": "1234",
                        "attachments": null,
                        "questionAndAnswer": null,
                        "oneThingBusiness": null
                    }
                ]
            }
        ],
        "servicesAndItems": [],
        "isEnabled": 1
    }
}

错误码

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

Demo

java

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