Guide de développement de l'interface DingTalk et de l'application d'enregistrement PHP

Interface DingTalk et guide de développement d'applications de pointage PHP

Avec la popularité de DingTalk en tant qu'outil principal pour le bureau et la gestion d'entreprise, de nombreuses entreprises espèrent utiliser DingTalk pour compléter les enregistrements de pointage des employés. Afin de répondre aux besoins des entreprises, nous pouvons utiliser l'interface fournie par DingTalk pour développer notre propre application de pointage. Cet article explique comment utiliser le langage PHP pour développer une application d'enregistrement DingTalk simple et fournit des exemples de code pertinents.

1. Préparation
Avant de commencer, nous devons préparer le matériel suivant :

1. Compte développeur DingTalk : créez un compte sur la plateforme de développement DingTalk et créez une nouvelle application. Obtenez l'AppKey et l'AppSecret de l'application. Ces deux paramètres seront utilisés dans les appels d'interface ultérieurs.
2. Environnement PHP : assurez-vous que votre serveur dispose d'un environnement PHP configuré et peut exécuter normalement le code PHP approprié.

2. Autorisation d'interface
Pour appeler l'interface de DingTalk, nous devons d'abord autoriser et obtenir un jeton d'accès. Ce qui suit est une fonction PHP simple pour obtenir un jeton d'accès via une requête HTTP :

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'];
}

Dans cette fonction, nous envoyons une requête à l'interface d'acquisition de jeton de DingTalk via une requête HTTP GET, et les paramètres incluent appKey et appSecret. L'interface renverra un résultat au format JSON, que nous analysons et renvoyons le champ access_token.

3. Obtenir des informations sur l'utilisateur
Avant d'effectuer l'opération de pointage, nous devons d'abord obtenir l'ID utilisateur de l'employé qui doit pointer. Voici un exemple de fonction pour obtenir l'ID utilisateur d'un employé spécifié :

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'];
}

Dans cette fonction, nous envoyons une requête à l'interface d'acquisition d'informations utilisateur de DingTalk via une requête HTTP GET. Les paramètres incluent le jeton d'accès et l'autorisation temporaire de l'employé. code (ce code peut être obtenu après que les employés ont cliqué sur le lien d'autorisation). L'interface renverra un résultat au format JSON, que nous analysons et renvoyons le champ userid.

4. Opération de pointage
Après avoir obtenu l'ID utilisateur, nous pouvons implémenter la fonction de pointage des employés en appelant l'interface de pointage. Voici un exemple de fonction pour implémenter le pointage des employés :

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;
}

Dans cette fonction, nous envoyons une requête à l'interface de pointage de DingTalk via une requête HTTP POST. Les paramètres incluent le jeton d'accès, l'ID utilisateur de l'employé, l'enregistrement. time recordTime et l'interface d'arrivée typetype. L'interface renverra un résultat au format JSON, qui contient les informations d'enregistrement de pointage de l'employé.

Il convient de noter que l'exemple ci-dessus implique une fonction http_post, qui est utilisée pour envoyer des requêtes HTTP POST. Ce qui suit est un exemple simple d'implémentation de la fonction http_post :

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. Exemple d'intégration
Nous intégrons maintenant les fonctions ci-dessus ensemble pour implémenter un exemple complet d'application punch-in DingTalk. Ce qui suit est un simple script PHP utilisé pour gérer les demandes de rappel DingTalk :

<?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);

Dans l'exemple de code ci-dessus, nous obtenons d'abord le code du code d'autorisation dans la demande de rappel, et obtenons l'ID utilisateur via le code d'autorisation. Ensuite, nous utilisons la date un jour avant l'heure actuelle comme heure d'enregistrement et appelons la fonction de pointage pour obtenir les informations d'enregistrement de pointage de l'employé. Enfin, nous générons les résultats des informations d'enregistrement punch-in via la fonction var_dump.

6. Résumé
Cet article explique comment utiliser le langage PHP pour développer une application d'enregistrement DingTalk simple. En appelant l'interface fournie par DingTalk, nous pouvons obtenir et traiter les enregistrements de pointage des employés. À mesure que DingTalk continue de se développer et de se mettre à niveau, nous pouvons développer et optimiser davantage en fonction de l'exemple de code présenté dans cet article pour répondre aux besoins commerciaux plus complexes. J'espère que cet article sera utile pour votre développement DingTalk et le développement d'applications !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!