钉钉中，如何通过连接器调用服务端api创建考勤班次？

在钉钉中，通过连接器调用服务端API创建考勤班次的步骤如下：

1. 首先，您需要在钉钉开发者后台创建一个自定义机器人，并获取到该机器人的Webhook地址。

2. 然后，使用HTTP客户端（如Java中的HttpClient或Python中的requests库）向该Webhook地址发送POST请求。请求体中需要包含以下参数：

   • "access_token": 钉钉应用的访问令牌，可以通过调用钉钉开放平台的接口获取。
   • "agent_id": 自定义机器人的ID。
   • "function_name": 要调用的函数名，即"createAttendanceShift"。
   • "args": 一个JSON对象，包含要创建的考勤班次的信息。例如：

{
    "companyId": "123456",
    "groupId": "7890",
    "shiftName": "早班",
    "startTime": "08:00",
    "endTime": "17:00",
    "workDays": ["Monday", "Tuesday", "Wednesday"]
}

其中，companyId是企业ID，groupId是部门ID，shiftName是班次名称，startTime和endTime分别是上班和下班时间，workDays是一个数组，表示工作日。

1. 如果请求成功，钉钉服务器会返回一个包含创建结果的JSON对象。如果创建成功，该对象中会包含新创建的考勤班次的ID；如果创建失败，则会包含错误信息。

获取班次详情旧版SDK https://open.dingtalk.com/document/orgapp/shift-query

调用本接口，根据班次ID查询班次的详细信息。

调用本接口，可查询班次的详细信息，如班次名称、打卡时间、休息时段等，如下图所示。

钉钉提供了各种不同规范的API，在调用钉钉服务端接口前，您需要完成以下准备工作：

调用流程如下：

步骤一：成为钉钉开发者，登录钉钉开发者后台。

步骤二：创建H5微应用，并获取AppKey和AppSecret。

步骤三：添加接口调用权限。

步骤四：开发者可以先通过调试工具调用API。

步骤五：钉钉开放平台提供了服务端API SDK，以Java示例，下载SDK。

步骤六：根据AppKey和AppSecret，获取企业应用内部访问接口凭证accessToken。

步骤七：根据accessToken，调用旧版服务端API-考勤。

考勤提供了丰富的接口开放能力，开发者通过API接口可以实现考勤和企业业务系统打通。

我们调用考勤中的创建班次接口，创建一个考勤班次，名称为接口创建班次。接口调用成功后，创建的班次在班次管理列表展示，如下图所示。