Masa Berlaku dan Perpanjangan Open Badge: Manajemen Siklus Hidup Kredensial Berbatas Waktu
Kredit CE, sertifikasi, dan lisensi semuanya kedaluwarsa. Atur expirationDate pada Open Badges dan perpanjang secara terprogram. Skema + alur kerja.
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.
Sebagian kredensial berlaku seumur hidup. Gelar sarjana tidak menjadi tidak benar hanya karena sepuluh tahun telah berlalu. Namun sebagian besar kredensial yang diterbitkan tim pelatihan justru sebaliknya: sertifikasi keamanan siber dua tahun, penyegaran keselamatan forklift tahunan, kartu CPR, atau kredit pendidikan berkelanjutan yang hanya berlaku untuk satu siklus pelaporan. Kredensial seperti ini adalah pernyataan bahwa seseorang kompeten per tanggal tertentu, dan pernyataan itu punya masa simpan.
Jika kredensial digital Anda tidak pernah kedaluwarsa, secara diam-diam Anda menyampaikan sesuatu yang tidak benar kepada pemberi kerja dan auditor. Artikel ini menjelaskan cara kerja masa berlaku di Open Badges, apa yang dilihat verifikator ketika kredensial habis masa berlakunya, dan alur perpanjangan praktis yang tidak mengharuskan Anda menulis kode kecuali Anda mau.
Catatan penamaan sebelum kita mulai
Banyak orang mencari “expirationDate”. Dalam spesifikasi Open Badges v2.0, field pada assertion (penghargaan itu sendiri, berbeda dengan badge class) bernama expires. Isinya string date-time ISO 8601. Field API yang Anda kirim saat menerbitkan kredensial di https://badges.ninja juga bernama expires. Idenya sama, hanya namanya berbeda dari yang kebanyakan orang tebak, jadi ingatlah hal ini saat membaca dokumen JSON-LD atau mencari di dokumentasi.
Dua hal yang perlu diketahui:
- Masa berlaku melekat pada award, bukan pada badge. Badge yang sama (misalnya “Annual Safety Training”) bisa diterbitkan untuk satu orang dengan masa berlaku berakhir Maret dan untuk orang lain berakhir September. Itu memang yang Anda inginkan, karena masa berlaku dihitung sejak masing-masing orang menyelesaikan pelatihan.
- Sifatnya opsional. Jika dikosongkan, kredensial tidak pernah kedaluwarsa.
Mengatur masa berlaku saat menerbitkan
Ada tiga cara untuk mengatur periode validitas. Mulailah dengan dua yang pertama, karena tidak memerlukan kode.
Formulir dasbor. Saat Anda membuat kredensial, formulir memiliki field tanggal “Expires” opsional di samping nama dan email penerima. Pilih tanggal lalu terbitkan. Hanya itu pekerjaannya.

Award massal. Jika Anda menerbitkan untuk satu kohort penuh, halaman award massal menerima CSV berisi penerima dan menerapkan satu tanggal kedaluwarsa untuk seluruh batch, sehingga kelas yang selesai pada minggu yang sama mendapat tanggal berakhir yang sama. Anda dapat menjeda dan melanjutkan batch besar. Panduan kami tentang menerbitkan Open Badges dari CSV membahas format filenya.
API. Untuk otomatisasi, misalnya hook sistem manajemen pembelajaran yang menerbitkan kredensial saat seseorang lulus ujian, tambahkan expires ke body POST /awards. Format yang diterima sama dengan issuedOn: milidetik epoch atau string tanggal 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 minimal lima karakter, issuedOn wajib diisi, dan panggilan yang berhasil mengembalikan HTTP 200 dengan { awardId }. URL verifikasi tidak ada dalam respons; Anda membangunnya dari id seperti yang ditunjukkan. Kontrak permintaan lengkap ada di referensi API awards.
Di balik layar, platform menormalkan apa pun yang Anda kirim menjadi string ISO 8601 dan menyimpannya di assertion Open Badges sebagai expires.
Apa yang dilihat verifikator
Ini bagian yang paling penting, karena tanggal kedaluwarsa yang tidak diperiksa siapa pun hanyalah hiasan.
Setiap award memiliki halaman verifikasi publik di https://badges.ninja/awards/<awardId>, dan tidak perlu mendaftar untuk melihatnya. Halaman tersebut membandingkan tanggal kedaluwarsa dengan tanggal hari ini setiap kali dimuat:
- Sebelum tanggal kedaluwarsa: halaman menampilkan kredensial sebagai valid dan menampilkan baris “valid until” beserta tanggalnya.
- Setelah tanggal kedaluwarsa: halaman beralih ke pemberitahuan “Expired on” beserta tanggalnya. Kredensialnya tetap ada, sehingga riwayat tetap utuh, tetapi tak seorang pun bisa mengira itu kredensial yang masih berlaku.
- Jika kredensial dicabut: pencabutan lebih diutamakan daripada kedaluwarsa. Kredensial yang dicabut tampil sebagai dicabut (revoked), bukan sekadar kedaluwarsa.
Verifikator mesin mendapat informasi yang sama dari dokumen JSON-LD Open Badge v2.0 di https://api.badges.ninja/certify-badge/award/<awardId>, tempat assertion membawa field expires. Alat apa pun yang membaca standar tersebut bisa menerapkan kebijakannya sendiri. Sistem HR mungkin langsung menolak kredensial yang kedaluwarsa, sementara direktori alumni mungkin menampilkannya sebagai “formerly certified”.
Kredensial juga membawa tanggal itu keluar. Tombol “Add to LinkedIn” pada award mengisi bulan dan tahun kedaluwarsa pada entri sertifikasi LinkedIn, sehingga profil orang tersebut mencerminkan tanggal berakhir yang sama dengan yang Anda tetapkan. Sertifikat PDF yang dapat diunduh juga mencetak tanggal “Expires” di samping tanggal penerbitan.
Satu konsekuensi yang perlu dinyatakan dengan jelas: kedaluwarsa dievaluasi pada saat seseorang melihatnya, bukan oleh job yang berjalan di sisi Anda. Anda tidak perlu melakukan apa pun pada hari kredensial berakhir. Tidak ada yang “dimatikan”; halaman verifikasi hanya menyampaikan kebenaran tentang tanggalnya.
Melihat apa yang akan segera berakhir
Program yang melacak perpanjangan membutuhkan daftar siapa yang akan segera perlu memperpanjang. Halaman awards di dasbor memiliki kolom Expires yang menampilkan tanggal tiap kredensial, dan membuka kredensial menampilkan banner: Active, Expires on a date, atau Expired on a date.

Untuk kampanye perpanjangan, cara termudah adalah memilih baris yang Anda perlukan lalu menggunakan Export CSV. Hasil ekspor menyertakan kolom “Valid To”. Buka di spreadsheet, urutkan berdasarkan kolom itu, dan Anda punya pipeline perpanjangan untuk kuartal berikutnya dalam sekitar satu menit.
Kami harus jujur soal satu keterbatasan: saat ini platform tidak mengirim email otomatis “kredensial Anda segera berakhir” kepada penerima. Anggap pengingat sebagai satu langkah dalam proses Anda sendiri. Pola yang umum adalah entri kalender setiap tanggal satu: ekspor CSV, saring tanggal dalam 60 sampai 90 hari ke depan, lalu kirim petunjuk perpanjangan kepada mereka dari alat email Anda yang biasa. Untuk sebagian besar program dengan beberapa ratus kredensial, ini memakan sepuluh menit per bulan dan jauh lebih ringan daripada membangun sistem notifikasi.
Jika Anda memang ingin mengotomatiskannya, endpoint daftar awards (GET /awards) mengembalikan kredensial Anda dalam halaman berisi 50, dan setiap record menyertakan masa berlakunya. Skrip terjadwal yang menelusuri daftar dan mengirim email kepada siapa pun yang berakhir dalam 60 hari adalah proyek kecil. Tetapi coba spreadsheet dulu dan otomatiskan hanya ketika langkah manual itu benar-benar merepotkan.
Pola perpanjangan
Ketika seseorang memperpanjang, apa yang seharusnya terjadi pada kredensialnya? Ada tiga pola yang masuk akal, dan pilihan yang tepat bergantung pada bagaimana program sertifikasi Anda didefinisikan.
Pola 1: Terbitkan award baru (direkomendasikan)
Ini pendekatan yang paling bersih. Orang tersebut menyelesaikan penyegaran atau ujian resertifikasi, dan Anda menerbitkan award baru dari badge yang sama dengan tanggal penerbitan baru dan tanggal kedaluwarsa baru. Kini mereka memegang dua kredensial dengan badge yang sama: yang lama, yang tampil kedaluwarsa, dan yang baru, yang tampil aktif.
Mengapa ini biasanya tepat:
- Setiap kredensial mencatat riwayat yang jujur: diterbitkan pada tanggal ini, berlaku sampai tanggal itu.
- URL publik yang lama tetap berfungsi dan tetap menyatakan “expired”, yang akurat. Tidak ada orang yang menyimpannya sebagai bookmark akan tersesat.
- Award baru mendapat URL verifikasi, sertifikat PDF, dan entri Add to LinkedIn sendiri. Orang tersebut dapat mengganti entri LinkedIn lama atau mempertahankan keduanya untuk menunjukkan sertifikasi yang berkelanjutan.
- Laporan Anda dapat menghitung perpanjangan hanya dengan menghitung award per penerima untuk satu badge.
Untuk menjaga hubungan antara yang lama dan yang baru, tuliskan di kriteria badge atau catatan Anda sendiri. Badge resertifikasi bisa berbunyi “Perpanjangan dari Annual Safety Training, berlaku setelah menyelesaikan penyegaran.” Jika Anda membutuhkan tautan yang pasti di sistem Anda, simpan nilai awardId lama dan baru bersama-sama di database manajemen pembelajaran atau HR Anda saat menerbitkan yang baru.
Pola 2: Ubah masa berlaku di tempat (hanya sebelum dikirim)
Platform mendukung pengeditan kredensial di tempat, tetapi hanya selama kredensial belum dikirim lewat email dan belum dicabut. Dalam rentang itu Anda dapat memperbaiki nama penerima, email, tanggal penerbitan, atau tanggal kedaluwarsa tanpa mengubah URL award. Ini untuk memperbaiki kesalahan, seperti tanggal kedaluwarsa yang salah ketik saat penyiapan, bukan untuk memperpanjang kredensial yang sudah dipegang seseorang.
Begitu kredensial telah dikirim lewat email ke penerima, kredensial itu terkunci. Jika Anda perlu mengubahnya setelah itu, jalur yang didukung adalah mencabutnya dan menerbitkan yang baru. Itu membawa kita ke pola ketiga.
Pola 3: Cabut dan terbitkan ulang
Gunakan ini ketika kredensial tidak boleh lagi dianggap valid sama sekali, misalnya orang tersebut kehilangan lisensinya di tengah masa berlaku, atau Anda menerbitkannya dengan badge yang salah. Ini bukan jalur perpanjangan yang normal, karena pencabutan memberi sinyal yang lebih kuat daripada kedaluwarsa: ia menyatakan bahwa kredensial itu seharusnya tidak dipercaya, bukan sekadar masa berlakunya berakhir. Panduan langkah demi langkah kami tentang mencabut Open Badge membahas kapan masing-masing tepat digunakan.
Aturan praktis yang baik: kedaluwarsa berarti masa berlaku berakhir; pencabutan berarti ada yang salah. Jangan mencabut kredensial hanya karena masa berlakunya habis. Biarkan kedaluwarsa dan simpan catatannya.
Memilih periode validitas
Tanggal kedaluwarsa adalah keputusan kebijakan, dan keliru menetapkannya menimbulkan masalah nyata. Beberapa panduan dari program yang kami lihat berjalan baik:
| Jenis kredensial | Validitas umum | Catatan |
|---|---|---|
| Sertifikasi keamanan siber atau TI | 2 sampai 3 tahun | Alat dan ancaman berubah dengan cepat |
| Pelatihan keselamatan tahunan | 12 bulan | Sering terkait persyaratan regulasi |
| Pertolongan pertama dan CPR | 2 tahun | Ikuti aturan regulator Anda, bukan kebiasaan |
| Kredit pendidikan berkelanjutan | Akhir siklus pelaporan | Selaraskan dengan siklus agar perpanjangan dikelompokkan bersama |
| Penyelesaian kursus | Tanpa kedaluwarsa | Penyelesaian adalah fakta; biarkan expires kosong |
Dua tips praktis. Pertama, selaraskan tanggal kedaluwarsa dengan ritme kalender bila memungkinkan. Jika semua orang dalam satu kohort berakhir pada tanggal yang sama, perpanjangan menjadi satu kampanye, bukan lima puluh. Kedua, jangan beri masa berlaku pada kredensial yang sebenarnya hanyalah catatan penyelesaian. Badge yang menyatakan “menghadiri konferensi 2025” tidak menjadi kurang benar tahun depan, dan tanggal kedaluwarsa di atasnya hanya menimbulkan kebingungan.
Contoh kasus: sertifikasi keamanan dua tahun
Mari kita rangkai semuanya untuk tim pelatihan yang menjalankan sertifikasi kesadaran keamanan bagi perusahaan dengan 400 karyawan.
- Rancang badge sekali saja di desainer visual. Beri nama, atur kriteria (lulus ujian dengan skor 80 persen atau lebih), dan jelaskan periode validitas dalam deskripsi agar penerima tahu apa yang mereka ikuti.
- Terbitkan dengan masa berlaku. Setelah setiap sesi ujian, unggah daftar yang lulus melalui award massal dengan masa berlaku diatur dua tahun ke depan. Setiap orang menerima email berisi tautan verifikasi, sertifikat PDF, dan tombol Add to LinkedIn.
- Periksa setiap bulan. Pada tanggal satu tiap bulan, ekspor daftar awards, urutkan berdasarkan “Valid To”, dan ambil semua orang yang berakhir dalam 90 hari ke depan.
- Undang mereka memperpanjang. Kirim tautan ujian resertifikasi kepada mereka dari alat email Anda yang biasa.
- Terbitkan perpanjangannya. Ketika seseorang lulus, terbitkan award baru dari badge yang sama dengan masa berlaku dua tahun yang baru. Yang lama tampil kedaluwarsa dengan sendirinya; jangan lakukan apa pun padanya.
- Jawab auditor dengan sebuah tautan. Ketika bagian kepatuhan bertanya apakah seseorang saat ini tersertifikasi, Anda mengirim URL verifikasi. URL itu menampilkan status terkini tanpa Anda perlu memeriksa apa pun.
Tanpa perangkat lunak kustom, tanpa cron job, tanpa migrasi. Itulah intinya: manajemen siklus hidup sebagian besar adalah soal memilih tanggal yang masuk akal dan memiliki kebiasaan bulanan.
Kesalahan umum
- Memberi masa berlaku pada semuanya. Simpan untuk kredensial yang maknanya memang memudar. Kalau tidak, Anda menciptakan pekerjaan perpanjangan tanpa manfaat.
- Mencampuradukkan kedaluwarsa dengan pencabutan. Mencabut kredensial yang sudah habis masa berlakunya menghancurkan riwayat sertifikasi berkelanjutan dan membuat orang tersebut tampak seolah tidak pernah valid.
- Melupakan zona waktu. Tanggal yang Anda pilih menjadi satu titik waktu. Jika regulasi berbunyi “berlaku hingga akhir Maret”, atur masa berlaku ke hari terakhir Maret, atau hari pertama April, tergantung bagaimana kebijakan Anda dibaca, dan konsistenlah.
- Berencana mengedit alih-alih menerbitkan ulang. Pengeditan hanya tersedia sebelum kredensial dikirim lewat email. Rencanakan perpanjangan sebagai award baru sejak awal.
- Tidak ada proses pengingat. Karena pemberitahuan kedaluwarsa tidak otomatis, kebiasaannya harus datang dari Anda. Masukkan ekspor bulanan ke kalender seseorang.
Langkah selanjutnya
Jika kredensial Anda akan diperiksa oleh sistem lain, ada baiknya membaca bagaimana dokumen yang membawa expires disusun: Panduan contoh JSON-LD Open Badge membahas setiap field dalam sebuah assertion. Dan jika Anda sedang menimbang apakah akan terus membayar platform per kredensial untuk semua ini, perbandingan alternatif Credly kami memaparkan biayanya.
Siap menerbitkan kredensial terverifikasi pertama Anda? Mulai gratis di badges.ninja — desainer visual, halaman verifikasi publik, sertifikat PDF, output Open Badge v2.0. Tanpa kartu kredit.
Bagaimana artikel ini dibuat
Beberapa artikel di blog ini disusun dengan bantuan asisten AI, lalu ditinjau, diperiksa faktanya, dan disunting oleh tim Badges Ninja sebelum dipublikasikan. Setiap contoh kode dan harga diverifikasi terhadap produk yang aktif. Baca selengkapnya tentang proses editorial dan AI kami di halaman proses editorial .

Tentang penulis
Nacho Coll
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.
Lainnya dari Nacho Coll
- Open Badges untuk Bootcamp Coding: Menerbitkan Kredensial Terverifikasi dalam Skala Angkatan19 Nov 2026 · 10menit baca
- Menyiapkan Webhook untuk Peristiwa Lencana: Integrasi Real-Time dengan Backend Anda16 Nov 2026 · 8menit baca
- Open Badge Baking Dijelaskan: Bagaimana JSON Tinggal di Dalam PNG9 Nov 2026 · 10menit baca


