DingTalk Interface and PHP Check-in Application Development Guide

DingTalk interface and PHP clock-in application development guide

With the popularity of DingTalk as the main tool for corporate office and management, many companies hope to use DingTalk to complete employee clock-in records. In order to meet the needs of enterprises, we can use the interface provided by DingTalk to develop our own clock-in application. This article will introduce how to use PHP language to develop a simple DingTalk check-in application and provide relevant code examples.

1. Preparation
Before starting, we need to prepare the following materials:

1. DingTalk developer account: Register an account on the DingTalk developer platform and create one New applications. Obtain the AppKey and AppSecret of the application. These two parameters will be used in subsequent interface calls.
2. PHP environment: Make sure your server has a PHP environment configured and can run the relevant PHP code normally.

2. Interface Authorization
In order to call DingTalk’s interface, we first need to authorize and obtain the access token. The following is a simple PHP function for obtaining an access token through an HTTP request:

function getAccessToken($appKey, $appSecret) {
    $url = "https://oapi.dingtalk.com/gettoken?appkey={$appKey}&appsecret={$appSecret}";
    $result = json_decode(file_get_contents($url), true);
    return $result['access_token'];
}

In this function, we send a request to DingTalk’s token acquisition interface through an HTTP GET request, and the parameters include appKey and appSecret. The interface will return a result in JSON format, which we parse and return the access_token field.

3. Obtain user information
Before performing the clock-in operation, we first need to obtain the user ID of the employee who needs to clock-in. The following is a sample function to obtain the user ID of a specified employee:

function getUserId($accessToken, $code) {
    $url = "https://oapi.dingtalk.com/user/getuserinfo?access_token={$accessToken}&code={$code}";
    $result = json_decode(file_get_contents($url), true);
    return $result['userid'];
}

In this function, we send a request to DingTalk’s user information acquisition interface through an HTTP GET request. The parameters include the access token and employee. Temporary authorization code code (this code can be obtained after the employee clicks the authorization link). The interface will return a result in JSON format, which we parse and return the userid field.

4. Punch-in operation
After obtaining the user ID, we can implement the employee clock-in function by calling the clock-in interface. The following is an example function to implement employee clock-in:

function clockIn($accessToken, $userId, $recordTime, $type) {
    $url = "https://oapi.dingtalk.com/attendance/list?access_token={$accessToken}";
    $data = [
        'userIds' => [$userId],
        'checkDateFrom' => $recordTime,
        'checkDateTo' => $recordTime,
        'isI18n' => 'false',
        'isIncludeLeave' => 'false',
        'isIncludeHoliday' => 'false',
        'isIncludeRecall' => 'false',
        'isIncludeMiss' => 'false',
        'isIncludeNotSignedOff' => 'true',
        'isIncludeNotSignedOff' => 'true'
    ];
    $result = json_decode(http_post($url, json_encode($data)), true);
    return $result;
}

In this function, we send a request to DingTalk’s clock-in interface through an HTTP POST request. The parameters include the access token, the employee’s user ID, and the record. Time recordTime and punch-in type type. The interface will return a result in JSON format, which contains the employee's punch-in record information.

It should be noted that the above example involves an http_post function, which is used to send HTTP POST requests. The following is a simple implementation example of the http_post function:

function http_post($url, $data) {
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $result = curl_exec($curl);
    curl_close($curl);
    return $result;
}

5. Integration Example
Now we will integrate the above functions together to implement a complete DingTalk check-in application example. The following is a simple PHP script for processing DingTalk callback requests:

<?php

$appKey = "your_app_key";
$appSecret = "your_app_secret";
$code = $_GET['code'];

$accessToken = getAccessToken($appKey, $appSecret);
$userId = getUserId($accessToken, $code);
$recordTime = date("Y-m-d", strtotime("-1 days"));
$result = clockIn($accessToken, $userId, $recordTime, "OnDuty");

var_dump($result);

In the above example code, we first obtain the authorization code code in the callback request, and obtain the user through the authorization code user ID. Then, we use the date one day before the current time as the recording time and call the punch-in function to obtain the employee's punch-in record information. Finally, we output the results of the punch-in record information through the var_dump function.

6. Summary
This article introduces how to use PHP language to develop a simple DingTalk check-in application. By calling the interface provided by DingTalk, we can obtain and process employee punch-in records. As DingTalk continues to develop and upgrade, we can further expand and optimize based on the sample code in this article to meet more complex business needs. I hope this article will be helpful to your DingTalk development and application development!

The above is the detailed content of DingTalk Interface and PHP Check-in Application Development Guide. For more information, please follow other related articles on the PHP Chinese website!