Tamat Tempoh dan Pembaharuan Open Badge: Pengurusan Kitaran Hayat untuk Kelayakan Berhad Masa

Kredit CE, pensijilan dan lesen semuanya tamat tempoh. Tetapkan expirationDate pada Open Badges dan baharui secara programatik. Skema + aliran kerja.

Nacho Coll Oleh Dikemas kini 10 minit bacaan
Kredit CE, pensijilan dan lesen semuanya tamat tempoh. Tetapkan expirationDate pada Open Badges dan baharui secara programatik. Skema + aliran kerja.

Sesetengah kelayakan berlaku seumur hidup. Ijazah tidak menjadi tidak benar hanya kerana sepuluh tahun telah berlalu. Tetapi sebahagian besar kelayakan yang dikeluarkan oleh pasukan latihan adalah sebaliknya: pensijilan keselamatan siber dua tahun, kursus segar semula keselamatan forklift tahunan, kad CPR, kredit pendidikan berterusan yang hanya sah untuk satu kitaran pelaporan. Kelayakan sebegini ialah pernyataan bahawa seseorang itu cekap setakat tarikh tertentu, dan pernyataan itu ada jangka hayatnya.

Jika kelayakan digital anda tidak pernah tamat tempoh, anda secara senyap memberitahu majikan dan juruaudit sesuatu yang tidak benar. Artikel ini menerangkan cara tamat tempoh berfungsi dalam Open Badges, apa yang dilihat oleh pengesah apabila kelayakan luput, dan aliran kerja pembaharuan praktikal yang tidak memerlukan anda menulis kod melainkan anda mahu.

Satu nota tentang penamaan sebelum kita mula

Anda akan mendapati ramai orang mencari “expirationDate”. Dalam spesifikasi Open Badges v2.0, medan pada sesuatu assertion (anugerah itu sendiri, berbeza daripada badge class) dipanggil expires. Ia ialah rentetan tarikh-masa ISO 8601. Medan API yang anda hantar semasa mengeluarkan kelayakan di https://badges.ninja juga dipanggil expires. Idea yang sama, nama yang berbeza daripada yang kebanyakan orang sangka, jadi ingat perkara ini apabila membaca dokumen JSON-LD atau mencari dalam dokumentasi.

Dua perkara yang patut diketahui:

  • Tamat tempoh terletak pada anugerah, bukan pada badge. Badge yang sama (katakan, “Annual Safety Training”) boleh dikeluarkan kepada seorang dengan tarikh tamat pada Mac dan kepada seorang lagi dengan tarikh tamat pada September. Itulah yang anda mahu, kerana kesahihan dikira dari saat setiap orang menamatkan latihan.
  • Ia pilihan. Jika ditinggalkan, kelayakan tidak akan tamat tempoh.

Menetapkan tarikh tamat semasa mengeluarkan

Anda ada tiga cara untuk menetapkan tempoh kesahihan. Mulakan dengan dua yang pertama, kerana ia tidak memerlukan kod.

Borang dashboard. Apabila anda mencipta kelayakan, borang mempunyai medan tarikh “Expires” pilihan di sebelah nama dan e-mel penerima. Pilih tarikh dan keluarkan. Itu sahaja.

New Award form

Anugerah pukal. Jika anda mengeluarkan kepada seluruh kohort, halaman anugerah pukal menerima CSV penerima dan menggunakan satu tarikh tamat untuk keseluruhan kelompok, supaya kelas yang tamat pada minggu yang sama mendapat tarikh luput yang sama. Anda boleh menjeda dan menyambung semula kelompok yang besar. Panduan kami tentang mengeluarkan Open Badges daripada CSV merangkumi format fail.

API. Untuk automasi, seperti hook sistem pengurusan pembelajaran yang mengeluarkan kelayakan apabila seseorang lulus peperiksaan, tambahkan expires pada badan POST /awards. Ia menerima format yang sama seperti issuedOn: milisaat epoch atau rentetan tarikh ISO.

// Issue a 2-year certification
const issuedOn = Date.now();
const twoYears = 2 * 365 * 24 * 60 * 60 * 1000;
const res = await fetch("https://api.badges.ninja/awards", {
  method: "POST",
  headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    badgeId: "your-badge-id",
    recipient: { name: "Jane Smith", email: "jane@example.com" },
    issuedOn,
    expires: issuedOn + twoYears,
  }),
});
const { awardId } = await res.json();       // 200 OK
const verifyUrl = `https://badges.ninja/awards/${awardId}`;

Panggilan yang sama dalam Python:

import time, requests
issued = int(time.time() * 1000)
two_years = 2 * 365 * 24 * 60 * 60 * 1000
res = requests.post(
    "https://api.badges.ninja/awards",
    headers={"X-Api-Key": API_KEY},
    json={
        "badgeId": "your-badge-id",
        "recipient": {"name": "Jane Smith", "email": "jane@example.com"},
        "issuedOn": issued,
        "expires": issued + two_years,
    },
)
award_id = res.json()["awardId"]            # 200 OK

Nama penerima mestilah sekurang-kurangnya lima aksara, issuedOn diperlukan, dan panggilan yang berjaya mengembalikan HTTP 200 dengan { awardId }. URL pengesahan tiada dalam respons; anda membinanya daripada id seperti ditunjukkan. Kontrak permintaan penuh ada dalam rujukan API awards.

Di sebalik tabir, platform menormalkan apa sahaja yang anda hantar kepada rentetan ISO 8601 dan menyimpannya dalam assertion Open Badge sebagai expires.

Apa yang dilihat oleh pengesah

Inilah bahagian yang paling penting, kerana tarikh tamat yang tiada siapa semak hanyalah perhiasan.

Setiap anugerah mempunyai halaman pengesahan awam di https://badges.ninja/awards/<awardId>, dan tiada pendaftaran diperlukan untuk melihatnya. Halaman itu membandingkan tarikh tamat dengan tarikh hari ini setiap kali ia dimuatkan:

  • Sebelum tarikh tamat: halaman memaparkan kelayakan sebagai sah dan menunjukkan baris “valid until” beserta tarikhnya.
  • Selepas tarikh tamat: halaman bertukar kepada notis “Expired on” beserta tarikh. Kelayakan masih ada, jadi sejarahnya kekal utuh, tetapi tiada siapa boleh tersalah menganggapnya sebagai kelayakan semasa.
  • Jika kelayakan dibatalkan: pembatalan mengatasi tamat tempoh. Kelayakan yang dibatalkan dipaparkan sebagai dibatalkan, bukan sekadar tamat tempoh.

Pengesah mesin mendapat maklumat yang sama daripada dokumen JSON-LD Open Badge v2.0 di https://api.badges.ninja/certify-badge/award/<awardId>, di mana assertion membawa medan expires. Mana-mana alat yang membaca standard ini boleh menerapkan dasarnya sendiri. Sistem HR mungkin menolak terus kelayakan yang tamat tempoh, manakala direktori alumni mungkin memaparkannya sebagai “formerly certified”.

Kelayakan itu juga membawa tarikh tersebut ke luar. Butang “Add to LinkedIn” pada anugerah mengisi bulan dan tahun tamat pada entri pensijilan LinkedIn, jadi profil orang itu mencerminkan tarikh luput yang sama yang anda tetapkan. Sijil PDF yang boleh dimuat turun turut mencetak tarikh “Expires” di sebelah tarikh dikeluarkan.

Satu akibat yang patut dinyatakan dengan jelas: tamat tempoh dinilai pada saat seseorang melihatnya, bukan oleh tugas yang berjalan di pihak anda. Anda tidak perlu berbuat apa-apa pada hari kelayakan luput. Tiada apa yang “dimatikan”; halaman pengesahan sekadar memaklumkan kebenaran tentang tarikh itu.

Melihat apa yang akan luput

Program yang menjejak pembaharuan memerlukan senarai siapa yang hampir perlu membaharui. Halaman anugerah dalam dashboard mempunyai lajur Expires yang menunjukkan tarikh setiap kelayakan, dan membuka kelayakan memaparkan sepanduk: Active, Expires on satu tarikh, atau Expired on satu tarikh.

Awards list

Untuk kempen pembaharuan, cara paling mudah ialah memilih baris yang anda perlukan dan menggunakan Export CSV. Eksport itu menyertakan lajur “Valid To”. Buka dalam hamparan, susun mengikut lajur itu, dan anda mempunyai saluran pembaharuan untuk suku tahun berikutnya dalam masa kira-kira seminit.

Kami perlu jujur tentang satu had: platform ini buat masa ini tidak menghantar e-mel automatik “kelayakan anda akan tamat tempoh tidak lama lagi” kepada penerima. Anggap peringatan sebagai satu langkah dalam proses anda sendiri. Corak biasa ialah entri kalendar pada hari pertama setiap bulan: eksport CSV, tapis tarikh dalam 60 hingga 90 hari akan datang, dan hantar arahan pembaharuan kepada mereka daripada alat e-mel biasa anda. Bagi kebanyakan program dengan beberapa ratus kelayakan, ini mengambil sepuluh minit sebulan dan jauh lebih kurang kerja berbanding membina sistem pemberitahuan.

Jika anda mahu mengautomasikannya, endpoint senarai anugerah (GET /awards) mengembalikan kelayakan anda dalam halaman 50 rekod, dan setiap rekod menyertakan tarikh tamatnya. Skrip berjadual yang menyusuri senarai dan menghantar e-mel kepada sesiapa yang tamat dalam masa 60 hari ialah projek kecil. Tetapi cuba hamparan dahulu dan automasikan hanya apabila langkah manual itu benar-benar menyusahkan.

Corak pembaharuan

Apabila seseorang membaharui, apakah yang patut berlaku kepada kelayakan itu? Terdapat tiga corak yang munasabah, dan yang sesuai bergantung pada cara program pensijilan anda ditakrifkan.

Corak 1: Keluarkan anugerah baharu (disyorkan)

Ini pendekatan yang paling kemas. Orang itu menamatkan kursus segar semula atau peperiksaan pensijilan semula, dan anda mengeluarkan anugerah baharu daripada badge yang sama dengan tarikh dikeluarkan yang baharu dan tarikh tamat yang baharu. Mereka kini memegang dua kelayakan dengan badge yang sama: yang lama, yang dipaparkan sebagai tamat tempoh, dan yang baharu, yang dipaparkan sebagai aktif.

Mengapa ini biasanya betul:

  • Setiap kelayakan merekodkan sejarah yang jujur: dikeluarkan pada tarikh ini, sah sehingga tarikh itu.
  • URL awam yang lama terus berfungsi dan terus mengatakan “expired”, yang tepat. Tiada sesiapa yang menanda buku URL itu disesatkan.
  • Anugerah baharu mendapat URL pengesahan, sijil PDF dan entri Add to LinkedIn sendiri. Orang itu boleh menggantikan entri LinkedIn lama atau mengekalkan kedua-duanya untuk menunjukkan pensijilan berterusan.
  • Laporan anda boleh mengira pembaharuan dengan hanya mengira anugerah bagi setiap penerima untuk sesuatu badge.

Untuk mengekalkan pautan antara yang lama dan yang baharu, letakkannya dalam kriteria badge atau rekod anda sendiri. Badge pensijilan semula boleh menyatakan “Renewal of Annual Safety Training, valid after completing the refresher.” Jika anda perlukan pautan tegar dalam sistem anda sendiri, simpan nilai awardId lama dan baharu bersama dalam pangkalan data pembelajaran atau HR anda apabila anda mengeluarkan yang baharu.

Corak 2: Sunting tarikh tamat di tempat (hanya sebelum dihantar)

Platform menyokong penyuntingan kelayakan di tempat, tetapi hanya selagi ia belum dihantar melalui e-mel dan belum dibatalkan. Dalam tempoh itu anda boleh membetulkan nama penerima, e-mel, tarikh dikeluarkan atau tarikh tamat tanpa mengubah URL anugerah. Ini untuk membetulkan kesilapan, seperti tarikh tamat yang salah ditaip semasa persediaan, bukan untuk melanjutkan kelayakan yang sudah dipegang seseorang.

Sebaik sahaja kelayakan dihantar melalui e-mel kepada penerima, ia dikunci. Jika anda perlu mengubahnya selepas itu, laluan yang disokong ialah membatalkannya dan mengeluarkan yang baharu. Itu membawa kita kepada corak ketiga.

Corak 3: Batalkan dan keluarkan semula

Gunakan ini apabila kelayakan itu tidak lagi patut dianggap sah langsung, misalnya orang itu kehilangan lesennya pada pertengahan tempoh, atau anda mengeluarkannya dengan badge yang salah. Ia bukan laluan pembaharuan biasa, kerana pembatalan menghantar isyarat yang lebih kuat daripada tamat tempoh: ia menyatakan kelayakan itu tidak sepatutnya dipercayai, bukan sekadar tempohnya sudah berakhir. Panduan langkah demi langkah kami tentang membatalkan Open Badge merangkumi bila setiap satu sesuai.

Peraturan praktikal yang baik: tamat tempoh bermakna tempoh telah berakhir; pembatalan bermakna ada sesuatu yang tidak kena. Jangan batalkan kelayakan hanya kerana ia telah luput. Biarkan ia tamat tempoh dan kekalkan rekod.

Memilih tempoh kesahihan

Tarikh tamat ialah keputusan dasar, dan tersilap membuatnya mendatangkan masalah sebenar. Beberapa panduan daripada program yang kami lihat berjalan dengan baik:

Jenis kelayakanKesahihan lazimNota
Pensijilan keselamatan siber atau IT2 hingga 3 tahunAlat dan ancaman berubah dengan pantas
Latihan keselamatan tahunan12 bulanSelalunya dikaitkan dengan keperluan kawal selia
Pertolongan cemas dan CPR2 tahunIkut peraturan pengawal selia anda, bukan kelaziman
Kredit pendidikan berterusanHujung kitaran pelaporanSelaraskan dengan kitaran supaya pembaharuan dikelompokkan bersama
Tamat kursusTiada tamat tempohPenamatan ialah fakta; biarkan expires kosong

Dua tip praktikal. Pertama, selaraskan tarikh tamat dengan rentak kalendar jika boleh. Jika semua orang dalam satu kohort luput pada tarikh yang sama, pembaharuan menjadi satu kempen dan bukannya lima puluh. Kedua, jangan letakkan tarikh tamat pada kelayakan yang sebenarnya rekod penamatan. Badge yang menyatakan “menghadiri persidangan 2025” tidak menjadi kurang benar tahun depan, dan tarikh tamat padanya hanya menimbulkan kekeliruan.

Contoh sebenar: pensijilan keselamatan dua tahun

Menggabungkan semuanya untuk pasukan latihan yang menjalankan pensijilan kesedaran keselamatan bagi syarikat dengan 400 pekerja.

  1. Reka bentuk badge sekali sahaja dalam pereka visual. Namakannya, tetapkan kriteria (lulus peperiksaan dengan skor 80 peratus atau lebih), dan huraikan tempoh kesahihan dalam perihalan supaya penerima tahu apa yang mereka sertai.
  2. Keluarkan dengan tarikh tamat. Selepas setiap sesi peperiksaan, muat naik senarai yang lulus melalui anugerah pukal dengan tarikh tamat ditetapkan dua tahun kemudian. Setiap orang menerima e-mel dengan pautan pengesahan, sijil PDF dan butang Add to LinkedIn.
  3. Semak setiap bulan. Pada hari pertama bulan, eksport senarai anugerah, susun mengikut “Valid To”, dan ambil semua yang akan tamat dalam 90 hari akan datang.
  4. Jemput mereka membaharui. Hantar pautan peperiksaan pensijilan semula kepada mereka daripada alat e-mel biasa anda.
  5. Keluarkan pembaharuan. Apabila seseorang lulus, keluarkan anugerah baharu daripada badge yang sama dengan tarikh tamat dua tahun yang baharu. Yang lama dipaparkan sebagai tamat tempoh dengan sendirinya; jangan buat apa-apa padanya.
  6. Jawab juruaudit dengan satu pautan. Apabila pematuhan bertanya sama ada seseorang kini bersijil, anda hantar URL pengesahan. Ia menunjukkan status semasa tanpa anda perlu menyemak apa-apa.

Tiada perisian khas, tiada cron job, tiada migrasi. Itulah intinya: pengurusan kitaran hayat sebahagian besarnya soal memilih tarikh yang munasabah dan mempunyai tabiat bulanan.

Kesilapan biasa

  • Menetapkan tarikh tamat pada semua perkara. Simpan ia untuk kelayakan yang maknanya benar-benar pudar. Jika tidak, anda mencipta kerja pembaharuan tanpa manfaat.
  • Mengelirukan tamat tempoh dengan pembatalan. Membatalkan kelayakan yang telah luput memusnahkan sejarah pensijilan berterusan dan menjadikan orang itu kelihatan seolah-olah tidak pernah sah.
  • Terlupa zon waktu. Tarikh yang anda pilih menjadi satu titik masa. Jika peraturan menyatakan “sah sehingga akhir Mac”, tetapkan tarikh tamat pada hari terakhir Mac, atau hari pertama April, bergantung pada cara dasar anda dibaca, dan bersikap konsisten.
  • Merancang untuk menyunting dan bukannya mengeluarkan semula. Penyuntingan hanya tersedia sebelum kelayakan dihantar melalui e-mel. Rancang pembaharuan sebagai anugerah baharu sejak awal.
  • Tiada proses peringatan. Memandangkan notis tamat tempoh tidak diautomasikan, tabiat itu mestilah datang daripada anda. Letakkan eksport bulanan dalam kalendar seseorang.

Ke mana selepas ini

Jika kelayakan anda akan disemak oleh sistem lain, berbaloi membaca cara dokumen yang membawa expires distrukturkan: Open Badge JSON-LD example walkthrough menerangkan setiap medan assertion. Dan jika anda sedang menimbang sama ada mahu terus membayar sesebuah platform bagi setiap kelayakan untuk semua ini, perbandingan alternatif Credly kami menghuraikan kosnya.

Bersedia untuk mengeluarkan kelayakan boleh disahkan yang pertama? Mulakan percuma di badges.ninja — pereka visual, halaman pengesahan awam, sijil PDF, output Open Badge v2.0. Tiada kad kredit diperlukan.

Nacho Coll

Tentang penulis

Founder & Engineer at Badges Ninja

Nacho founded Badges Ninja to make issuing verifiable digital credentials as simple as a single API call — Open Badge v2.0 badges and certificates, minted, hosted, and verifiable without standing up your own issuer infrastructure. Writes about the Open Badges spec, credential verification, and running a credentialing platform serverless on AWS, from the operator side of the wire.

Kembali ke Blog

Artikel Berkaitan