开发者社区 问答 正文

钉钉请假怎么修改人员状态接口?

钉钉请假怎么修改人员状态接口?

展开
收起
三分钟热度的鱼 2023-08-08 16:34:47 362 分享 版权
2 条回答
写回答
取消 提交回答
  • 要修改钉钉中人员的请假状态,您可以使用钉钉开放平台提供的接口 - "更新请假状态(approval.update)"。以下是一般情况下修改人员请假状态接口的步骤:

    1. 首先,确保您已经完成了钉钉开放平台的接入和权限验证,并获得了相应的访问令牌(access_token)。

    2. 使用POST请求方式,向以下接口地址发送请求:

      https://oapi.dingtalk.com/topapi/attendance/approval/update?access_token=ACCESS_TOKEN
      

      将上述URL中的ACCESS_TOKEN替换为您获取到的有效访问令牌。

    3. 在请求的Body中,传递相应的参数来指定需要修改的人员请假状态。例如:

      {
      "userid": "员工UserID",
      "leave_status": [{
       "start_time": 1627708800000,
       "end_time": 1627795200000,
       "status": "0"
      }]
      }
      

      其中,"userid"为员工的用户ID,"start_time"和"end_time"表示请假开始和结束时间(以时间戳形式),"status"表示请假状态,"0"表示取消请假,"1"表示重新请假。

    4. 发送请求,并根据接口返回的结果进行处理。

    请注意,具体的接口参数和使用方法可能会因钉钉开放平台的更新而有所变化。建议您参考钉钉官方文档中关于"更新请假状态(approval.update)"接口的详细说明和示例,以确保正确使用该接口进行人员请假状态的修改。

    2023-08-08 22:09:09
    赞同 展开评论
  • 北京阿里云ACE会长

    要实现钉钉请假并修改人员状态,可以调用钉钉开放API中的接口:

    Copy
    topapi/user/updateworkstatus
    主要的请求参数包括:

    userid:需要修改状态的员工ID
    workstatus:状态值,比如year_off(年假)、sick_leave(病假) 等
    begin_time:状态起始时间
    end_time:状态结束时间
    请求URL:

    Copy
    https://oapi.dingtalk.com/topapi/user/updateworkstatus?access_token={access_token}
    access_token为调用该接口的应用的访问令牌。

    请求体示例:

    json
    Copy
    {
    "userid":"UserID",
    "workstatus":"year_off",
    "begin_time":"2022-01-01",
    "end_time":"2022-01-02"
    }
    设置对应的状态和时间后,该员工即进入请假状态。

    调用此接口成功后,员工在钉钉的个人信息 - 工作状态中,会显示为对应的请假状态。

    同时,其他同事也能在组内看到该员工的请假状态。

    需要注意的是,workstatus支持的状态值有限,不能自定义。

    2023-08-08 20:02:05
    赞同 展开评论