Paylaşım ve Doğrulama

badges.ninja üzerindeki her ödülün, oturum açmadan herkesin erişebileceği herkese açık bir doğrulama sayfası vardır. Alıcılar rozetlerini sosyal medyada, e-posta yoluyla veya doğrudan bir bağlantıyı kopyalayarak paylaşabilir.

Alıcıların da kendi portalları var

badges.ninja üzerinden bir rozet kazandıysanız, badges.ninja/me adresinde (parola gerekmez) oturum açarak tüm rozetlerinizi tek bir yerde görebilir ve badges.ninja/u/<kullanıcı-adınız> adresinde herkese açık bir profil oluşturabilirsiniz. Bkz. Alıcı Portalı.

Herkese Açık Ödül Sayfası

Her ödülün herkese açık bir URL'si vardır:

https://badges.ninja/awards/{guid}

Bu sayfa rozet görselini (IPFS'ten yüklenir), rozet adını ve açıklamasını, alıcı adını, veren kuruluşun adını ve logosunu, veriliş tarihini ve varsa son geçerlilik tarihini ve alıcının rozeti kazanmak için karşıladığı kriterleri görüntüler. Bağlantıya sahip olan herkes sayfayı açarak kimlik bilgisinin gerçek olduğunu doğrulayabilir.

Veren kuruluş bir LinkedIn organizasyon kimliği belirlediyse, LinkedIn profiline ekle düğmesi görünür ve alıcı kimlik bilgisini doğrudan LinkedIn Lisanslar ve Sertifikalar bölümüne kaydedebilir. Rozeti İndir düğmesi orijinal rozet görselini (doğrudan IPFS'ten) sunar ve PDF İndir anlık olarak yazdırılabilir A4 boyutunda bir sertifika oluşturur.

Herkese Açık Paylaşım Sayfası

Paylaşım sayfası sosyal paylaşım seçenekleri sunar:

https://badges.ninja/awards/{guid}/share

Bu sayfadan alıcılar rozetlerini şu platformlarda paylaşabilir:

• LinkedIn — LinkedIn akışlarına gönderi olarak yayınlar veya (veren kuruluş bir LinkedIn organizasyon kimliği belirlemişse) Add to LinkedIn Profile düğmesi aracılığıyla kimlik bilgisini doğrudan profillerine ekler
• Twitter / X — rozet bağlantısı ve özel paylaşım metniyle bir tweet gönderir
• Facebook — Facebook zaman tünellerinde paylaşır
• WhatsApp — rozet bağlantısını içeren bir mesaj gönderir
• Telegram — rozet bağlantısını içeren bir mesaj gönderir
• Send Email — bir veya birden fazla alıcıya stilize bir e-posta gönderen sayfa içi bir kalıcı pencere açar (bkz. aşağıdaki E-posta ile Paylaşım)
• Copy Link — doğrulama URL'sini panoya kopyalar
• Embed snippets — rozeti bir web sitesine, intranete veya e-posta imzasına yerleştirmek için kullanıma hazır <img> ve <iframe> HTML kodlarını kopyalar

QR ile Doğrulama

Özel bir doğrulama sayfası, kendi URL'sini gösteren taranabilir bir QR kodu sunar — basılı sertifikalar, etkinlik afişleri veya LinkedIn ekran görüntüleri için mükemmeldir.

https://badges.ninja/verify/{guid}

QR kodunu telefon kamerasıyla tarayan herkes canlı doğrulama sayfasına ulaşır ve rozetin badges.ninja üzerinde barındırıldığını, Open Badge v2.0 spesifikasyonuna uyduğunu ve (Pro planda) Matchain üzerinden zincir üzerinde sabitlendiğini doğrulayabilir. Alıcı kimliği SHA-256 karması olarak gösterilir, böylece e-posta adresleri herkese açık olarak hiçbir zaman ifşa edilmez.

PDF Sertifikası

Her ödülün herkese açık doğrulama sayfasında bir Download Certificate düğmesi bulunur. Üzerine tıklamak; rozet görselini, alıcı adını, veren kuruluşu, kriterleri, veriliş tarihini, isteğe bağlı son geçerlilik tarihini ve canlı doğrulama URL'sine bağlanan bir QR kodunu içeren, baskıya hazır A4 boyutunda bir PDF'yi anlık olarak oluşturur.

Sosyal Medya Önizlemeleri

Bir rozet bağlantısı LinkedIn, X, Slack, Facebook, WhatsApp veya e-postada paylaşıldığında, platform paylaşım uç noktasını alır ve badges.ninja'nın yaydığı Open Graph meta verilerinden zengin bir kart oluşturur:

• Önizleme görseli olarak rozet görseli
• Başlık olarak rozet adı
• Açıklamada veren kuruluşun adı ve alıcı adı

Bu, rozetlerin nerede paylaşılırsa paylaşılsın profesyonel görünmesini sağlar — alıcıların kendi görsellerini eklemesine veya metin yazmasına gerek yoktur. Önizleme sunucu tarafında /certify-badge/award/{guid}/share-html adresinde oluşturulur ve CDN kenarında önbelleğe alınır, böylece önizlemeler ilk paylaşımda bile anında görüntülenir.

E-posta ile Paylaşım

Rozet ödüllerini iki şekilde e-postayla gönderebilirsiniz:

Herkese Açık Paylaşım Sayfasından

Alıcılar, paylaşım sayfasındaki Send Email düğmesine tıklayarak rozetlerini arkadaşları, mentorları veya potansiyel işverenleriyle paylaşabilir. Bir veya daha fazla e-posta adresi, isteğe bağlı bir konu ve kişisel bir mesaj girdikleri bir kalıcı pencere açılır:

Her alıcı, alıcının kişisel mesajıyla birlikte stilize edilmiş bir HTML e-postası ve herkese açık ödül sayfasını görüntülemek için tek tıklamalı bir düğme alır:

Kontrol Panelinden

Veren kuruluşlar, kontrol panelindeki Awards sayfasından herhangi bir ödülü e-posta yoluyla gönderebilir:

1. Ödülü Awards sayfasında bulun.
2. Satırdaki Send düğmesine tıklayın veya ayrıntı kalıcı penceresini açıp Resend email düğmesine tıklayın.
3. Alıcı e-postasını girin ve gönderin.

Her iki akış için de aynı e-posta şablonu kullanılır.

Open Badge v2.0 JSON Uç Noktaları

Diğer rozet platformlarıyla birlikte çalışabilirlik için badges.ninja, şu herkese açık uç noktalarda standart Open Badge v2.0 JSON sağlar:

Uç Nokta	Açıklama
/certify-badge/issuer/{guid}	Veren kuruluş profili JSON
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (ödül)

Bu uç noktalar Open Badge v2.0 spesifikasyonuyla uyumlu JSON-LD döndürür. Diğer rozet platformları ve doğrulayıcılar kimlik bilgilerini doğrulamak için bu verileri kullanabilir.

Örnek — bir ödülü doğrulayın:

curl https://api.badges.ninja/certify-badge/award/abc123-def456

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Assertion",
  "id": "https://api.badges.ninja/certify-badge/award/abc123-def456",
  "recipient": {
    "type": "email",
    "identity": "sha256$..."
  },
  "badge": "https://api.badges.ninja/certify-badge/badge/xyz789",
  "issuedOn": "2025-01-15T00:00:00.000Z",
  "verification": {
    "type": "hosted"
  }
}

IPFS Görsel URL'leri

Rozet görselleri, kendi ağ geçidimiz olan ipfs.ninja aracılığıyla IPFS'e (InterPlanetary File System) sabitlenir. Bu şu anlama gelir:

• Görseller kalıcıdır ve içerik adresine sahiptir — değiştirilemez veya sessizce yenisiyle değiştirilemez
• Open Badge JSON'undaki görsel URL'leri https://ipfs.ninja/ipfs/{cid} biçimindedir
• Aynı içerik kimliği, herhangi bir herkese açık IPFS ağ geçidi (cloudflare-ipfs.com, ipfs.io, vb.) üzerinden çözümlenebilir — rozetleriniz tek bir sağlayıcıya bağlı değildir

Görsel Open Badge iddiasının bir parçası olduğundan, rozet tasarımını daha sonra değiştirmek önceden verilmiş ödülleri bozmaz: eski IPFS CID'si sonsuza kadar çözümlenebilir kalır, böylece geçmiş ödüller, yeni rozet vermeleri için tasarımı yenilemiş olsanız bile orijinal görsellerini korur.