查看单个日程的签到详情
GET
/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}/signin最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口根据日程ID查询单个日程签到与未签到人员列表。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 日历应用中日程读权限 | API Explorer |
第三方企业应用 | 暂不支持 | 日历应用中日程读权限 | 暂不支持 |
第三方个人应用 | 支持 | 日历应用中日程读权限 | API Explorer |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | invalidParameter | forwardErrorMessage | 参数异常 |
请求参数
Path 参数
userId
string
必需
日程所属用户的unionId,可通过根据userid获取用户详情接口获取。
calendarId
string
必需
日程所属的日历id,统一为primary,表示用户的主日历。
eventId
string
日程ID。
Query 参数
maxResults
string
必需
查询返回结果数,最大值200。
nextToken
string
可选
分页游标。
如果一个查询条件一次无法全部返回结果,会返回分页token,下次查询带上该token后会返回后续数据,直到分页token为null表示数据已经全部查询完毕。
type
string
必需
签到信息类型,取值:
Header 参数
x-acs-dingtalk-access-token
string
必需
调用服务端接口的授权凭证。
Body 参数application/json
object {0}
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
nextToken
string
可选
分页游标。
如果一个查询条件一次无法全部返回结果,会返回分页token,下次查询带上该token后会返回后续数据,直到分页token为null表示数据已经全部查询完毕。
users
array [object {3}]
签到信息列表。
userId
string
可选
用户的userid。
displayName
string
用户名。
checkInTime
integer
可选
签到时间,毫秒级时间戳。
示例
{
"nextToken": "string",
"users": [
{
"userId": "string",
"displayName": "string",
"checkInTime": 0
}
]
}
最后修改时间: 2 年前