Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
新版服务端API(DingTalk OpenAPI)
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取访问凭证通讯录应用市场客户管理服务群考勤待办任务日程钉盘会议专属钉钉合作空间钉工牌数据目录制造业数字化管理师宜搭应用开发文档
获取访问凭证通讯录应用市场客户管理服务群考勤待办任务日程钉盘会议专属钉钉合作空间钉工牌数据目录制造业数字化管理师宜搭应用开发文档
  1. 日程
  • 创建日程
    POST
  • 查询日程列表
    GET
  • 删除日程
    DELETE
  • 修改日程
    PUT
  • 查询单个日程详情
    GET
  • 添加日程参与者
    POST
  • 删除日程参与者
    POST
  • 设置日程响应邀请状态
    POST
  • 获取用户忙闲信息
    POST
  • 查看单个日程的签到详情
    GET
  • 查询日历
    GET
  1. 日程

查看单个日程的签到详情

GET
http://127.0.0.1/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}/signin
新版服务端API(DingTalk OpenAPI)/日程
最后修改时间:2022-08-30 09:19:21
责任人:未设置

说明#

调用本接口根据日程ID查询单个日程签到与未签到人员列表。
服务地址:api.dingtalk.com

权限#

要调用此API,需要以下权限之一。
应用类型是否支持权限API Explorer调试
企业内部应用支持日历应用中日程读权限API Explorer
第三方企业应用暂不支持日历应用中日程读权限暂不支持
第三方个人应用支持日历应用中日程读权限API Explorer

错误码#

HttpCode错误码错误信息说明
400invalidParameterforwardErrorMessage参数异常

请求参数

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}
示例
{}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1/v1.0/calendar/users//calendars//events//signin?maxResults=&type=' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功
application/json
Body
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
    }
  ]
}
上一页
获取用户忙闲信息
下一页
查询日历
Built with