DingTalk-Schnittstelle und PHP-Check-in-Anwendungsentwicklungshandbuch

DingTalk-Schnittstelle und Entwicklungsleitfaden für PHP-Einstempelanwendungen

Angesichts der Beliebtheit von DingTalk als Haupttool für Unternehmensbüros und -management hoffen viele Unternehmen, DingTalk zur Vervollständigung der Einstempelaufzeichnungen ihrer Mitarbeiter nutzen zu können. Um den Anforderungen von Unternehmen gerecht zu werden, können wir die von DingTalk bereitgestellte Schnittstelle verwenden, um unsere eigene Clock-In-Anwendung zu entwickeln. In diesem Artikel wird erläutert, wie Sie mithilfe der PHP-Sprache eine einfache DingTalk-Check-in-Anwendung entwickeln und relevante Codebeispiele bereitstellen.

1. Vorbereitung
Bevor wir beginnen, müssen wir die folgenden Materialien vorbereiten:

1. DingTalk-Entwicklerkonto: Registrieren Sie ein Konto auf der DingTalk-Entwicklerplattform und erstellen Sie eine neue Anwendung. Rufen Sie den AppKey und das AppSecret der Anwendung ab. Diese beiden Parameter werden in nachfolgenden Schnittstellenaufrufen verwendet.
2. PHP-Umgebung: Stellen Sie sicher, dass auf Ihrem Server eine PHP-Umgebung konfiguriert ist und der entsprechende PHP-Code normal ausgeführt werden kann.

2. Schnittstellenautorisierung
Um die Schnittstelle von DingTalk aufzurufen, müssen wir zunächst eine Autorisierung durchführen und ein Zugriffstoken erhalten. Das Folgende ist eine einfache PHP-Funktion zum Erhalten eines Zugriffstokens über eine HTTP-Anfrage:

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 dieser Funktion senden wir eine Anfrage über eine HTTP-GET-Anfrage an die Token-Erfassungsschnittstelle von DingTalk, und die Parameter umfassen appKey und appSecret. Die Schnittstelle gibt ein Ergebnis im JSON-Format zurück, das wir analysieren und das Feld „access_token“ zurückgeben.

3. Erhalten Sie Benutzerinformationen
Bevor wir den Einstempelvorgang durchführen, müssen wir zunächst die Benutzer-ID des Mitarbeiters einholen, der sich einstempeln muss. Das Folgende ist eine Beispielfunktion zum Abrufen der Benutzer-ID eines bestimmten Mitarbeiters:

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 dieser Funktion senden wir eine Anfrage an die Benutzerinformationserfassungsschnittstelle von DingTalk über eine HTTP-GET-Anfrage. Zu den Parametern gehören das Zugriffstoken und die temporäre Autorisierung des Mitarbeiters Code. Code (dieser Code kann erhalten werden, nachdem Mitarbeiter auf den Autorisierungslink geklickt haben). Die Schnittstelle gibt ein Ergebnis im JSON-Format zurück, das wir analysieren und das Feld „userid“ zurückgeben.

4. Einstempelvorgang
Nachdem wir die Benutzer-ID erhalten haben, können wir die Einstempelfunktion des Mitarbeiters implementieren, indem wir die Einstempelschnittstelle aufrufen. Das Folgende ist eine Beispielfunktion zum Implementieren des Einstempelns von Mitarbeitern:

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 dieser Funktion senden wir eine Anfrage an die Einstempelschnittstelle von DingTalk über eine HTTP-POST-Anfrage. Zu den Parametern gehören das Zugriffstoken, die Benutzer-ID des Mitarbeiters und die Aufzeichnung time recordTime und die Clock-In-Schnittstelle. Die Schnittstelle gibt ein Ergebnis im JSON-Format zurück, das die Punch-In-Datensatzinformationen des Mitarbeiters enthält.

Es ist zu beachten, dass es sich bei dem obigen Beispiel um eine http_post-Funktion handelt, die zum Senden von HTTP-POST-Anfragen verwendet wird. Das Folgende ist ein einfaches Implementierungsbeispiel der http_post-Funktion:

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. Integrationsbeispiel
Jetzt integrieren wir die oben genannten Funktionen zusammen, um ein vollständiges DingTalk-Punch-In-Anwendungsbeispiel zu implementieren. Das Folgende ist ein einfaches PHP-Skript, das zur Verarbeitung von DingTalk-Rückrufanforderungen verwendet wird:

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

Im obigen Beispielcode erhalten wir zunächst den Autorisierungscode in der Rückrufanforderung und erhalten die Benutzer-ID über den Autorisierungscode. Anschließend verwenden wir das Datum einen Tag vor der aktuellen Uhrzeit als Aufnahmezeit und rufen die Punch-In-Funktion auf, um die Punch-In-Datensatzinformationen des Mitarbeiters zu erhalten. Schließlich geben wir die Ergebnisse der Punch-In-Datensatzinformationen über die Funktion var_dump aus.

6. Zusammenfassung
In diesem Artikel wird erläutert, wie Sie mithilfe der PHP-Sprache eine einfache DingTalk-Check-in-Anwendung entwickeln. Durch Aufrufen der von DingTalk bereitgestellten Schnittstelle können wir Mitarbeiter-Punch-In-Datensätze abrufen und verarbeiten. Während DingTalk sich weiterentwickelt und aktualisiert, können wir es basierend auf dem Beispielcode in diesem Artikel weiter erweitern und optimieren, um komplexere Geschäftsanforderungen zu erfüllen. Ich hoffe, dass dieser Artikel für Ihre DingTalk-Entwicklung und Anwendungsentwicklung hilfreich sein wird!

Das obige ist der detaillierte Inhalt vonDingTalk-Schnittstelle und PHP-Check-in-Anwendungsentwicklungshandbuch. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!