获取发送给用户的通知
GET
/v1.0/yida/corpNotifications/{userId}最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取发送给用户的通知。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 宜搭任务读权限 | API Explorer |
第三方企业应用 | 支持 | 宜搭任务读权限 | API Explorer |
第三方个人应用 | 暂不支持 | 宜搭任务读权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | invalidParameter.methodInputs.invalidFormat | 数据格式错误:%s | 数据格式错误 |
400 | invalidParameter.number.exceed | 数字超过限制:%s | 数字超过限制 |
400 | invalidParameter.methodInputs.invalid | 入参校验失败:%s | 入参校验失败 |
400 | dataNotExist.form.notExists | 表单不存在:%s | 表单不存在 |
500 | dataModified.form.formAlreadyModified | 实例数据已修改, 请刷新当前页面:%s | 实例数据已经修改 |
500 | unclassifiedError | 异常:%s | 通用异常信息 |
请求参数
Path 参数
userId
string
必需
用户的userid。
Query 参数
corpId
string
必需
组织的corpId。
token
string
必需
验权token。
校验方式如下:md5(corpId + userId + code)。md5取32位大写值。
每个企业有自己的唯一code。
pageNumber
string
分页页码。
pageSize
string
分页大小。
language
string
语言,取值:
keyword
string
可选
表单中组件数据模糊搜索。
appTypes
string
应用标识列表。
processCodes
string
流程code列表。
instanceCreateFromTimeGMT
string
可选
流程创建时间起始值。
instanceCreateToTimeGMT
string
可选
流程创建时间终止值。
createFromTimeGMT
string
创建时间起始值。
createToTimeGMT
string
创建时间终止值。
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
object {0}
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
totalCount
integer
总数量。
pageNumber
integer
当前第几页。
data
array [object {13}]
通知列表。
createTimeGMT
string
创建时间。
activityId
string
节点ID。
creatorUserId
string
可选
创建者的userid。
corpId
string
组织corpid。
titleInEnglish
string
标题英文。
modifiedTimeGMT
string
修改时间。
appType
string
应用ID。
processCode
string
流程编码。
mobileUrl
string
手机号url。
formInstanceId
string
流程实例ID。
instStatus
string
实例状态,取值:
title
string
标题。
url
string
链接。
示例
{
"totalCount": 0,
"pageNumber": 0,
"data": [
{
"createTimeGMT": "string",
"activityId": "string",
"creatorUserId": "string",
"corpId": "string",
"titleInEnglish": "string",
"modifiedTimeGMT": "string",
"appType": "string",
"processCode": "string",
"mobileUrl": "string",
"formInstanceId": "string",
"instStatus": "string",
"title": "string",
"url": "string"
}
]
}
最后修改时间: 2 年前