Antara Muka DingTalk dan Panduan Pembangunan Aplikasi Daftar Masuk PHP

Antara muka DingTalk dan panduan pembangunan aplikasi jam masuk PHP

Dengan populariti DingTalk sebagai alat utama untuk pejabat dan pengurusan korporat, banyak syarikat berharap untuk menggunakan DingTalk untuk melengkapkan rekod jam masuk pekerja. Untuk memenuhi keperluan perusahaan, kami boleh menggunakan antara muka yang disediakan oleh DingTalk untuk membangunkan aplikasi jam masuk kami sendiri. Artikel ini akan memperkenalkan cara menggunakan bahasa PHP untuk membangunkan aplikasi daftar masuk DingTalk yang mudah dan menyediakan contoh kod yang berkaitan.

1. Persediaan
Sebelum kita mula, kita perlu menyediakan bahan berikut:

1. Akaun pembangun DingTalk: Daftar akaun di platform pembangun DingTalk dan buat aplikasi baharu. Dapatkan AppKey dan AppSecret aplikasi kedua-dua parameter ini akan digunakan dalam panggilan antara muka berikutnya.
2. Persekitaran PHP: Pastikan pelayan anda mempunyai persekitaran PHP yang dikonfigurasikan dan boleh menjalankan kod PHP yang berkaitan seperti biasa.

2. Keizinan Antara Muka
Untuk menghubungi antara muka DingTalk, kami perlu memberi kebenaran dan mendapatkan token akses terlebih dahulu. Berikut ialah fungsi PHP mudah untuk mendapatkan token akses melalui permintaan 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'];
}

Dalam fungsi ini, kami menghantar permintaan kepada antara muka pemerolehan token DingTalk melalui permintaan HTTP GET, dan parameter termasuk appKey dan appSecret. Antara muka akan mengembalikan hasil dalam format JSON, yang kami huraikan dan mengembalikan medan access_token.

3. Dapatkan maklumat pengguna
Sebelum melakukan operasi jam masuk, kami perlu mendapatkan ID pengguna pekerja yang perlu masuk jam. Berikut ialah contoh fungsi untuk mendapatkan ID pengguna pekerja tertentu:

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

Dalam fungsi ini, kami menghantar permintaan kepada antara muka pemerolehan maklumat pengguna DingTalk melalui permintaan HTTP GET Parameter termasuk token akses dan kebenaran sementara pekerja kod. (kod ini boleh diperolehi selepas pekerja mengklik pautan kebenaran). Antara muka akan mengembalikan hasil dalam format JSON, yang kami huraikan dan mengembalikan medan id pengguna.

4. Operasi tebuk masuk
Selepas mendapatkan ID pengguna, kami boleh melaksanakan fungsi jam masuk pekerja dengan memanggil antara muka jam masuk. Berikut ialah contoh fungsi untuk melaksanakan jam masuk pekerja:

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

Dalam fungsi ini, kami menghantar permintaan ke antara muka jam masuk DingTalk melalui permintaan HTTP POST Parameter termasuk token akses, ID pengguna pekerja, rakaman rekod masaMasa dan antara muka jenis jam. Antara muka akan mengembalikan hasil dalam format JSON, yang mengandungi maklumat rekod punch-in pekerja.

Perlu diingat bahawa contoh di atas melibatkan fungsi http_post, yang digunakan untuk menghantar permintaan HTTP POST. Berikut ialah contoh pelaksanaan mudah bagi fungsi 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. Contoh integrasi
Kini kami menyepadukan fungsi di atas bersama-sama untuk melaksanakan contoh aplikasi tebuk masuk DingTalk yang lengkap. Berikut ialah skrip PHP mudah yang digunakan untuk mengendalikan permintaan panggil balik 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);

Dalam kod contoh di atas, kami mula-mula mendapatkan kod kod kebenaran dalam permintaan panggil balik, dan mendapatkan ID pengguna melalui kod kebenaran. Kemudian, kami menggunakan tarikh sehari sebelum masa semasa sebagai masa rakaman dan memanggil fungsi punch-in untuk mendapatkan maklumat rekod punch-in pekerja. Akhir sekali, kami mengeluarkan hasil maklumat rekod punch-in melalui fungsi var_dump.

6. Ringkasan
Artikel ini memperkenalkan cara menggunakan bahasa PHP untuk membangunkan aplikasi daftar masuk DingTalk yang mudah. Dengan memanggil antara muka yang disediakan oleh DingTalk, kami boleh mendapatkan dan memproses rekod punch-in pekerja. Memandangkan DingTalk terus membangun dan menaik taraf, kami boleh mengembangkan dan mengoptimumkan lagi berdasarkan kod sampel dalam artikel ini untuk memenuhi keperluan perniagaan yang lebih kompleks. Saya harap artikel ini akan membantu pembangunan DingTalk dan pembangunan aplikasi anda!

Atas ialah kandungan terperinci Antara Muka DingTalk dan Panduan Pembangunan Aplikasi Daftar Masuk PHP. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!