应用通知
应用待办消息
描述
查询教职工待办的应用消息。目前支持的有签报，发文，阅文，出国审批，干部离沪审批
支持的模式
- authorization_code
- client_credentials
- password
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/info/todo
请求参数
| 参数名 | 是否必填 | 备注 |
|---|---|---|
| userId | 是 | 学工号，当授权为authorization_code和password模式时可省略 |
返回参数
data
| 参数名 | 类型 | 备注 |
|---|---|---|
| yuewen | object | 阅文的待办消息，结构体 |
| qianbao | object | 签报的待办消息，结构体 |
| fawen | object | 发文的待办消息，结构体 |
| leaderLeave | object | 干部离沪的待办消息，结构体 |
| teacherAbroad | object | 出国审批的待办消息，结构体 |
object
| 参数名 | 类型 | 备注 |
|---|---|---|
| todo | number | 待办的条数 |
| support_messages | bool | 是否支持具体的待办消息明细 |
| messages | object array | 待办消息明细 |
message
| 参数名 | 类型 | 备注 |
|---|---|---|
| index | number | 排序号 |
| href | string | 消息的链接 |
| title | string | 消息的标题 |
请求示例
curl -i -H "Authorization: Bearer e447e4b4b8e23973b42c44b8d5415603" "https://api.ecnu.edu.cn/api/v1/info/todo?userId=20****73"返回示例
json
{
"errCode": 0,
"errMsg": "success",
"requestId": "dc7613d7-7669-460d-b20b-680dd06af6f5",
"data": {
"yuewen": {
"todo": 0,
"support_messages": false,
"messages": []
},
"fawen": {
"todo": 0,
"support_messages": false,
"messages": []
},
"qianbao": {
"todo": 3,
"support_messages": false,
"messages": []
},
"leaderLeave": {
"todo": 2,
"support_messages": true,
"messages": [{
"index": 1,
"href": "http://iprocess.ecnu.edu.cn/ProjectWeb/Page/CadresLeave/CadresApprovalProcess.aspx?step=approverAudit&sn=******",
"title": "领导人员离沪外出申请[2021]06230001"
}, {
"index": 2,
"href": "http://iprocess.ecnu.edu.cn/ProjectWeb/Page/CadresLeave/CadresApprovalProcess.aspx?step=approverAudit&sn=*****",
"title": "领导人员离沪外出申请[2021]06230002"
}]
},
"teacherAbroad": {
"todo": 0,
"support_messages": true,
"messages": []
}
}
}主动推送应用待办消息
描述
应用方主动推送待办的消息，通常用于消息推送的实时集成。
支持的模式
- client_credentials
请求方法
POST
请求地址
https://api.ecnu.edu.cn/api/v1/info/message/todo/{type}
type 为应用的类型，目前支持以下三种
- leaderleave 干部离沪
- teacherabroad 出国境审批
- internaltest 内部测试
欢迎更多应用接入实现消息待办统一推送。
请求参数
以 content-type: application/json 方式，在 body 内提交请求参数
| 参数名 | 是否必填 | 备注 |
|---|---|---|
| userId | 是 | 学工号 |
| messageId | 是 | 消息的Id，由调用方生成。对某个应用内必须唯一 |
| messageHref | 是 | 消息的链接地址 |
| messageTitle | 是 | 消息的标题 |
返回参数
无
请求示例
curl -X POST -H "Authorization: Bearer a4169ff1c5503d6eb94f84d13b6776e0" -H "content-type: application/json" -d '{\"userId\":\"20150073\",\"messageId\":\"12345\",\"messageHref\":\"https://www.baidu.com\",\"messageTitle\":\"test123\"}' https://api.ecnu.edu.cn/api/v1/info/message/todo/internaltest返回示例
json
{"errCode":0,"errMsg":"success","requestId":"a1fd3e91-0d03-4d3e-9b96-2fb3040b6158","data":null}主动推送已办结的应用待办消息
描述
应用方主动推送已办结的待办的消息，通常用于消息推送的实时集成。
支持的模式
- client_credentials
请求方法
PUT
请求地址
https://api.ecnu.edu.cn/api/v1/info/message/todo/{type}
type 为应用的类型，目前支持以下三种
- leaderleave 干部离沪
- teacherabroad 出国境审批
- internaltest 内部测试
欢迎更多应用接入实现消息待办统一推送。
请求参数
| 参数名 | 是否必填 | 备注 |
|---|---|---|
| messageId | 是 | 消息的Id，由调用方生成。对某个应用内必须唯一 |
返回参数
无
请求示例
curl -X PUT -H "Authorization: Bearer a4169ff1c5503d6eb94f84d13b6776e0" "https://api.ecnu.edu.cn/api/v1/info/message/todo/internaltest?messageId=12345"返回示例
json
{"errCode":0,"errMsg":"success","requestId":"a1fd3e91-0d03-4d3e-9b96-2fb3040b6158","data":null}查询主动推送的应用待办消息
描述
应用方查询主动推送的待办的消息状态，通常用于消息推送的实时集成。
支持的模式
- client_credentials
请求方法
GET
请求地址
https://api.ecnu.edu.cn/api/v1/info/message/todo/{type}
type 为应用的类型，目前支持以下三种
- leaderleave 干部离沪
- teacherabroad 出国境审批
- internaltest 内部测试
欢迎更多应用接入实现消息待办统一推送。
请求参数
| 参数名 | 是否必填 | 备注 |
|---|---|---|
| messageId | 是 | 消息的Id，由调用方生成。对某个应用内必须唯一 |
返回参数
无
请求示例
curl -H "Authorization: Bearer a4169ff1c5503d6eb94f84d13b6776e0" "https://api.ecnu.edu.cn/api/v1/info/message/todo/internaltest?messageId=12345"返回示例
json
{"errCode":0,"errMsg":"success","requestId":"a1fd3e91-0d03-4d3e-9b96-2fb3040b6158","data":null}