Open Badge Son Kullanma ve Yenileme: Süreli Kimlik Bilgileri için Yaşam Döngüsü Yönetimi
Sürekli eğitim kredileri, sertifikalar ve lisanslar sona erer. Open Badges üzerinde expirationDate belirleyin ve bunları programatik olarak yenileyin. Şema + iş akışı.
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.
Bazı kimlik bilgileri ömür boyu geçerlidir. Bir diploma, üzerinden on yıl geçti diye doğru olmaktan çıkmaz. Ancak eğitim ekiplerinin verdiği kimlik bilgilerinin büyük bir kısmı tam tersidir: iki yıllık bir siber güvenlik sertifikası, yıllık forklift güvenliği tazeleme eğitimi, bir CPR kartı, yalnızca tek bir raporlama döneminde geçerli olan sürekli eğitim kredisi. Bu kimlik bilgileri, birinin belirli bir tarih itibarıyla yetkin olduğunun beyanıdır ve bu beyanın bir raf ömrü vardır.
Dijital kimlik bilgileriniz hiç sona ermiyorsa, işverenlere ve denetçilere sessizce doğru olmayan bir şey söylüyorsunuz demektir. Bu yazıda Open Badges’te son kullanma tarihinin nasıl çalıştığını, bir kimlik bilgisinin süresi dolduğunda doğrulayıcının ne gördüğünü ve siz istemedikçe kod yazmanızı gerektirmeyen pratik bir yenileme iş akışını anlatıyoruz.
Başlamadan önce bir adlandırma notu
İnsanların “expirationDate” diye arama yaptığını görürsünüz. Open Badges v2.0 spesifikasyonunda bir assertion’ın (rozet sınıfından farklı olarak, verilen ödülün kendisi) alanına expires denir. Bu, ISO 8601 biçiminde bir tarih-saat dizesidir. https://badges.ninja üzerinde bir kimlik bilgisi verirken gönderdiğiniz API alanı da expires adını taşır. Aynı fikir, ama çoğu kişinin tahmin ettiğinden farklı bir ad; bir JSON-LD belgesi okurken veya dokümanlarda arama yaparken bunu aklınızda tutun.
Bilmeye değer iki ayrıntı:
- Son kullanma tarihi rozette değil, ödülde tutulur. Aynı rozet (örneğin “Annual Safety Training”) bir kişiye Mart’ta, bir diğerine Eylül’de sona erecek şekilde verilebilir. İstediğiniz de budur, çünkü geçerlilik her kişinin eğitimi tamamladığı andan itibaren sayılır.
- İsteğe bağlıdır. Boş bırakırsanız kimlik bilgisi hiç sona ermez.
Verirken son kullanma tarihi belirleme
Geçerlilik süresi belirlemenin üç yolu vardır. Kod gerektirmeyen ilk ikisiyle başlayın.
Panel formu. Bir kimlik bilgisi oluştururken formda alıcının adı ve e-postasının yanında isteğe bağlı bir “Expires” tarih alanı bulunur. Tarihi seçin ve verin. İş bu kadar.

Toplu ödüller. Tüm bir gruba veriyorsanız, toplu ödüller sayfası alıcıların bulunduğu bir CSV alır ve tek bir son kullanma tarihini tüm partiye uygular; böylece aynı hafta bitiren bir sınıf aynı bitiş tarihini alır. Büyük bir partiyi duraklatıp devam ettirebilirsiniz. CSV’den Open Badges verme anlatımımız dosya biçimini kapsar.
API. Otomasyon için, örneğin biri sınavı geçtiğinde kimlik bilgisi veren bir öğrenim yönetim sistemi kancası için, POST /awards gövdesine expires ekleyin. issuedOn ile aynı biçimleri kabul eder: epoch milisaniye veya ISO tarih dizesi.
// 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}`;
Aynı çağrı Python’da:
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
Alıcı adı en az beş karakter olmalı, issuedOn zorunludur ve başarılı bir çağrı { awardId } ile HTTP 200 döndürür. Doğrulama URL’si yanıtta yoktur; onu gösterildiği gibi kimlikten siz oluşturursunuz. Tam istek sözleşmesi awards API referansında yer alır.
Arka planda platform, gönderdiğiniz her şeyi ISO 8601 dizesine normalleştirir ve Open Badges assertion’ında expires olarak saklar.
Doğrulayıcının gördüğü
En önemli kısım bu, çünkü kimsenin kontrol etmediği bir son kullanma tarihi süstür.
Her ödülün https://badges.ninja/awards/<awardId> adresinde herkese açık bir doğrulama sayfası vardır ve görüntülemek için kayıt gerekmez. Sayfa, her yüklendiğinde son kullanma tarihini bugünün tarihiyle karşılaştırır:
- Son kullanma tarihinden önce: Sayfa kimlik bilgisini geçerli olarak gösterir ve tarihle birlikte bir “geçerlilik sonu” satırı görüntüler.
- Son kullanma tarihinden sonra: Sayfa, tarihli bir “Süresi doldu” bildirimine geçer. Kimlik bilgisi yerinde durur, geçmiş korunur, ama kimse onu güncel sanamaz.
- Kimlik bilgisi iptal edildiyse: İptal, son kullanmanın önüne geçer. İptal edilmiş bir kimlik bilgisi yalnızca süresi dolmuş değil, iptal edilmiş olarak görünür.
Makine doğrulayıcılar aynı bilgiyi https://api.badges.ninja/certify-badge/award/<awardId> adresindeki Open Badge v2.0 JSON-LD belgesinden alır; assertion’da expires alanı bulunur. Standardı okuyan her araç kendi politikasını uygulayabilir. Bir İK sistemi süresi dolmuş kimlik bilgisini tümden reddedebilir, bir mezunlar dizini ise onu “eskiden sertifikalı” olarak gösterebilir.
Kimlik bilgisi tarihi dışarıya da taşır. Ödül üzerindeki “Add to LinkedIn” düğmesi, LinkedIn sertifika girişindeki bitiş ayını ve yılını doldurur; böylece kişinin profili sizin belirlediğiniz bitiş tarihini yansıtır. İndirilebilir PDF sertifika da verilme tarihinin yanına bir “Expires” tarihi basar.
Açıkça söylemeye değer bir sonuç: Son kullanma, birinin baktığı anda değerlendirilir; sizin tarafınızda çalışan bir görev tarafından değil. Bir kimlik bilgisinin süresinin dolduğu gün hiçbir şey yapmanız gerekmez. Hiçbir şey “kapatılmaz”; doğrulama sayfası tarih hakkında sadece doğruyu söyler.
Süresi dolmak üzere olanları görme
Yenilemeleri takip eden programların, kimin yenileme sırasına geldiğini gösteren bir listeye ihtiyacı vardır. Panelde ödüller sayfasında her kimlik bilgisinin tarihini gösteren bir Expires sütunu bulunur ve bir kimlik bilgisini açtığınızda bir başlık görünür: Active, Expires on a date veya Expired on a date.

Bir yenileme kampanyası için en kolay yol, ilgilendiğiniz satırları seçip Export CSV kullanmaktır. Dışa aktarım bir “Valid To” sütunu içerir. Bunu bir e-tabloda açın, bu sütuna göre sıralayın; yaklaşık bir dakikada gelecek çeyrek için bir yenileme hattınız olur.
Bir sınırı dürüstçe belirtelim: Platform şu anda alıcılara kendiliğinden otomatik “kimlik bilginizin süresi yakında doluyor” e-postaları göndermiyor. Hatırlatmayı kendi sürecinizin bir adımı olarak düşünün. Yaygın bir model, her ayın birinde bir takvim girişidir: CSV’yi dışa aktarın, önümüzdeki 60 ila 90 gün içindeki tarihleri süzün ve bu kişilere yenileme talimatlarınızı normal e-posta aracınızdan gönderin. Birkaç yüz kimlik bilgisi olan çoğu program için bu ayda on dakika sürer ve bir bildirim sistemi kurmaktan çok daha az iştir.
Yine de otomatikleştirmek isterseniz, ödül listesi uç noktası (GET /awards) kimlik bilgilerinizi 50’şerlik sayfalar halinde döndürür ve her kayıt son kullanma tarihini içerir. Listeyi dolaşan ve 60 gün içinde sona erecek herkese e-posta gönderen zamanlanmış bir betik küçük bir projedir. Ama önce e-tabloyu deneyin ve yalnızca elle yapılan adım gerçekten can sıktığında otomatikleştirin.
Yenileme kalıpları
Biri yenilediğinde kimlik bilgisine ne olmalı? Üç makul kalıp var ve doğrusu sertifika programınızın nasıl tanımlandığına bağlı.
Kalıp 1: Yeni bir ödül verin (önerilen)
Bu en temiz yaklaşımdır. Kişi tazeleme eğitimini veya yeniden sertifikalandırma sınavını tamamlar ve siz aynı rozetten, yeni bir verilme tarihi ve yeni bir son kullanma tarihiyle yeni bir ödül verirsiniz. Artık aynı rozetle iki kimlik bilgisi vardır: süresi dolmuş görünen eski ve etkin görünen yeni.
Bunun genellikle doğru olmasının nedenleri:
- Her kimlik bilgisi dürüst bir geçmiş kaydeder: şu tarihte verildi, şu tarihe kadar geçerli.
- Eski herkese açık URL çalışmaya ve “süresi doldu” demeye devam eder; bu doğrudur. Yer imine ekleyen hiç kimse yanıltılmaz.
- Yeni ödül kendi doğrulama URL’sini, PDF sertifikasını ve Add to LinkedIn girişini alır. Kişi eski LinkedIn girişini değiştirebilir ya da kesintisiz sertifikasyonu göstermek için ikisini de tutabilir.
- Raporlarınız, bir rozet için alıcı başına ödül sayısını sayarak yenilemeleri basitçe sayabilir.
Eski ile yeni arasındaki bağı korumak için bunu rozet kriterlerine veya kendi kayıtlarınıza yazın. Yeniden sertifikalandırma rozeti şunu diyebilir: “Annual Safety Training yenilemesi, tazeleme eğitimi tamamlandıktan sonra geçerlidir.” Kendi sisteminizde sağlam bir bağ gerekiyorsa, yenisini verirken eski ve yeni awardId değerlerini öğrenim yönetimi veya İK veritabanınızda birlikte saklayın.
Kalıp 2: Son kullanma tarihini yerinde düzenleyin (yalnızca gönderilmeden önce)
Platform bir kimlik bilgisinin yerinde düzenlenmesini destekler, ancak yalnızca henüz e-postayla gönderilmemişse ve iptal edilmemişse. Bu aralıkta ödülün URL’sini değiştirmeden alıcı adını, e-postayı, verilme tarihini veya son kullanma tarihini düzeltebilirsiniz. Bu, kurulum sırasında yanlış yazılmış bir son kullanma tarihi gibi hataları düzeltmek içindir; birinin zaten sahip olduğu bir kimlik bilgisini uzatmak için değil.
Bir kimlik bilgisi alıcıya e-postayla gönderildikten sonra kilitlenir. Bundan sonra değiştirmeniz gerekirse desteklenen yol, onu iptal edip yenisini vermektir. Bu da bizi üçüncü kalıba getiriyor.
Kalıp 3: İptal edin ve yeniden verin
Kimlik bilgisi artık hiç geçerli sayılmamalıysa bunu kullanın; örneğin kişi dönem ortasında lisansını kaybettiyse veya yanlış rozetle verdiyseniz. Normal yenileme yolu değildir, çünkü iptal, son kullanmadan daha güçlü bir sinyal verir: kimlik bilgisinin yalnızca süresinin bitmediğini, güvenilmemesi gerektiğini söyler. Open Badge iptali adım adım anlatımımız hangisinin ne zaman uygun olduğunu kapsar.
İyi bir pratik kural: son kullanma, sürenin bittiği anlamına gelir; iptal, bir şeylerin yanlış olduğu anlamına gelir. Kimlik bilgilerini sadece süresi doldu diye iptal etmeyin. Sona ermelerine izin verin ve kaydı tutun.
Geçerlilik süresi seçme
Son kullanma tarihleri politika kararlarıdır ve yanlış yapmak gerçek baş ağrıları yaratır. İyi işleyen programlardan bazı öneriler:
| Kimlik bilgisi türü | Tipik geçerlilik | Notlar |
|---|---|---|
| Siber güvenlik veya BT sertifikası | 2 ila 3 yıl | Araçlar ve tehditler hızla değişir |
| Yıllık güvenlik eğitimi | 12 ay | Çoğunlukla bir yasal gereklilikle bağlantılıdır |
| İlk yardım ve CPR | 2 yıl | Bir gelenek değil, düzenleyicinizin kuralını izleyin |
| Sürekli eğitim kredisi | Raporlama döneminin sonu | Yenilemelerin toplu olması için döneme hizalayın |
| Kurs tamamlama | Son kullanma yok | Tamamlama bir gerçektir; expires alanını boş bırakın |
İki pratik ipucu. Birincisi, mümkün olduğunda son kullanma tarihlerini bir takvim ritmine hizalayın. Bir grubun herkesi aynı tarihte sona ererse yenileme elli kampanya yerine tek kampanya olur. İkincisi, aslında tamamlama kaydı olan kimlik bilgilerine son kullanma tarihi koymayın. “2025 konferansına katıldı” diyen bir rozet gelecek yıl daha az doğru olmaz ve üzerindeki son kullanma tarihi yalnızca kafa karışıklığı yaratır.
Çalışılmış bir örnek: iki yıllık güvenlik sertifikası
Hepsini, 400 çalışanlı bir şirket için güvenlik farkındalığı sertifikası yürüten bir eğitim ekibi üzerinden bir araya getirelim.
- Rozeti bir kez tasarlayın, görsel tasarımcıda. Adlandırın, kriterleri belirleyin (sınavı yüzde 80 veya üzeri puanla geçmek) ve alıcılar neye kayıt olduklarını bilsin diye geçerlilik süresini açıklamada belirtin.
- Son kullanma tarihiyle verin. Her sınav oturumundan sonra geçenlerin listesini, son kullanma tarihi iki yıl sonrasına ayarlanmış şekilde toplu ödüllerle yükleyin. Herkes doğrulama bağlantısı, PDF sertifikası ve Add to LinkedIn düğmesi içeren e-postasını alır.
- Aylık kontrol edin. Ayın birinde ödül listesini dışa aktarın, “Valid To” sütununa göre sıralayın ve önümüzdeki 90 gün içinde süresi dolacak herkesi çekin.
- Yenilemeye davet edin. Bu kişilere yeniden sertifikalandırma sınavı bağlantısını normal e-posta aracınızdan gönderin.
- Yenilemeyi verin. Biri geçtiğinde aynı rozetten yeni iki yıllık son kullanma tarihiyle yeni bir ödül verin. Eskisi kendiliğinden süresi dolmuş görünür; ona hiçbir şey yapmayın.
- Denetçilere bir bağlantıyla yanıt verin. Uyum ekibi bir kişinin şu an sertifikalı olup olmadığını sorduğunda doğrulama URL’sini gönderirsiniz. Siz hiçbir şey kontrol etmeden güncel durumu gösterir.
Özel yazılım yok, cron işi yok, geçiş yok. Mesele de bu: yaşam döngüsü yönetimi çoğunlukla mantıklı tarihler seçmek ve aylık bir alışkanlığa sahip olmaktır.
Sık yapılan hatalar
- Her şeye son kullanma tarihi koymak. Bunu, anlamı gerçekten sönen kimlik bilgilerine saklayın. Aksi halde fayda sağlamayan yenileme işi yaratırsınız.
- Son kullanmayı iptalle karıştırmak. Süresi dolan kimlik bilgilerini iptal etmek, kesintisiz sertifikasyon geçmişini yok eder ve kişiyi hiç geçerli olmamış gibi gösterir.
- Saat dilimini unutmak. Seçtiğiniz tarih bir zaman noktası olur. Bir düzenleme “Mart sonuna kadar geçerli” diyorsa, politikanızın okunuşuna göre son kullanma tarihini Mart’ın son gününe veya Nisan’ın ilk gününe ayarlayın ve tutarlı olun.
- Yeniden vermek yerine düzenlemeyi planlamak. Düzenleme yalnızca kimlik bilgisi e-postayla gönderilmeden önce mümkündür. Yenilemeleri en baştan yeni ödüller olarak planlayın.
- Hatırlatma süreci olmaması. Son kullanma bildirimleri otomatik olmadığından alışkanlık sizden gelmelidir. Aylık dışa aktarımı birinin takvimine koyun.
Sırada ne var
Kimlik bilgileriniz başka sistemlerce kontrol edilecekse, expires alanını taşıyan belgenin nasıl yapılandırıldığını okumaya değer: Open Badge JSON-LD örnek anlatımı bir assertion’ın her alanını inceler. Tüm bunlar için kimlik bilgisi başına bir platforma ödemeye devam edip etmeyeceğinizi tartıyorsanız, Credly alternatifi karşılaştırmamız maliyetleri ortaya koyar.
İlk doğrulanabilir kimlik bilginizi vermeye hazır mısınız? badges.ninja’da ücretsiz başlayın — görsel tasarımcı, herkese açık doğrulama sayfası, PDF sertifika, Open Badge v2.0 çıktısı. Kredi kartı gerekmez.
Bu yazı nasıl hazırlandı
Bu blogdaki bazı yazılar bir yapay zeka asistanının yardımıyla hazırlanır, ardından yayınlanmadan önce Badges Ninja ekibi tarafından incelenir, doğrulanır ve düzenlenir. Her kod örneği ve fiyat, canlı ürünle karşılaştırılarak doğrulanır. Editoryal ve yapay zeka sürecimiz hakkında daha fazla bilgiyi editoryal süreç sayfamızda bulabilirsiniz .

Yazar hakkında
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.
Diğer yazıları Nacho Coll
- Kodlama Bootcamp'leri için Open Badges: Dönem Ölçeğinde Doğrulanabilir Kimlik Bilgileri Düzenleme19 Kas 2026 · 9dk okuma
- Rozet Olayları için Webhook Kurulumu: Arka Ucunuzla Gerçek Zamanlı Entegrasyon16 Kas 2026 · 8dk okuma
- Open Badge Baking Açıklaması: JSON, PNG'nin İçinde Nasıl Yaşar?9 Kas 2026 · 9dk okuma


