# Task APIs
- Task APIs提供对于任务中心可办、待办等各种流程平台相关的信息查询和管理。V1版文档均已废弃，以下为V2规范。
- V2版本包括三部分，InfoPlus APIs由流程平台提供，授权提供流程、任务相关的查询、管理的服务；Task Integration API目的是为了集成第三方的可办、待办等信息，需第三方实现由网络信息中心完成集成。
- 使用本组API前请先阅读概述，使用前的准备工作请参考此处，令牌的获取参考此处，构造请求请参考此处，返回数据请参考此处，除非特殊注明，所有开放式API有着通用的返回结构。
- 每个API的授权方式、授权范围和是否API SDK支持请查看以下每个API详细的表述。
# InfoPlus APIs
- InfoPlus-2.x系列提供与V1版的语义的兼容，并支持SJTU OAuth授权。
- V2版API主要由InfoPlus提供，需InfoPlus授权。
- 详细标准请参考 InfoPlus APIs
# Task Integration API
- 此API并非平台方提供，而是需要应用方提供。
- 作用是对非InfoPlus的任务集成，需实现InfoPlus-2.x系列接口。
- 实现规范详见系统集成接入，第三方按规范实现可办、待办、抄送、已完成等接口中的一个或多个即可集成进交我办。
# 发送任务更新消息
# 功能介绍
第三方应用系统如果通过Task Integration方式集成接入了交我办，那么在第三方系统用户待办任务数量或者抄送数量发生变化时可通过此API通知交我办的门户实时更新用户的待办和抄送显示的数字。
# 请求参数
| 参数名 | 描述 |
|---|---|
| uid | 用户jaccount |
| tid | 更新消息类型，缺省为task，目前支持task,cc |
| eid | 事件id，具体视消息类型而定 |
# 请求数据格式
设置Content-Type请求头为application/x-www-form-urlencoded
# 响应参数
- 返回的内容为如下结构 Structure
{
"error":{string}, // 错误信息
"time":{long}, // 时间戳。注意是单位为"毫秒数"的Unix时间戳
"message":{ // Message数据结构
"uid":{string}, // 用户的GUID
"type":{string}, // 消息类型
"eid":{string}, // 事件id（如有）
"time":{long}, // 该消息的产生时间戳，单位是毫秒
"payload":{string} // 尚不支持
}
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
# 请求示例
POST /v2/task/message?access_token=token HTTP/1.1
Host: api.sjtu.edu.cn
Content-Type: application/x-www-form-urlencoded
uid=yech
1
2
3
4
5
2
3
4
5
# 响应示例
示例 成功返回的数据
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"error":"",
"time":1616402587,
"message":{
"uid":"3f233acb-1b11-03f2-0903-39cd1b6fbb29",
"type":"task",
"time":1616402587
}
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12