Paylaşım ve Doğrulama

badges.ninja üzerindeki her kimlik bilgisinin, oturum açmadan herkesin erişebildiği herkese açık bir doğrulama sayfası vardır. Alıcılar dijital rozetlerini sosyal medyada, e-postayla veya doğrudan bağlantıyı kopyalayarak paylaşabilir.

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

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

Herkese Açık Kimlik Bilgisi Sayfası

Her kimlik bilgisinin herkese açık bir URL'si vardır:

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

Bu sayfa rozet görselini, rozetin adını ve açıklamasını, alıcı adını, düzenleyenin adını ve logosunu, veriliş tarihini ve varsa son kullanma tarihini, ayrıca alıcının rozeti kazanmak için karşıladığı ölçütleri gösterir. Bağlantıya sahip herkes sayfayı açarak kimlik bilgisinin gerçek olduğunu doğrulayabilir.

Kimlik bilgisi sayfasında her zaman bir Add to LinkedIn profile düğmesi bulunur; böylece alıcı kimlik bilgisini doğrudan LinkedIn Licenses & Certifications bölümüne kaydedebilir. (Düzenleyen bir LinkedIn kuruluş kimliği belirlediyse LinkedIn doğrulanmış Şirket Sayfasını otomatik doldurur; aksi halde düzenleyenin adı kullanılır.) Tek bir Download açılır menüsü iki seçenek sunar: Rozet görseli (orijinal PNG) ve Sertifika (/certify-badge/award/{guid}/pdf adresinde anında oluşturulan, yazdırılabilir bir A4 PDF).

Herkese Açık Paylaşım Sayfası

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

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

Alıcılar bu sayfadan rozetlerini şurada paylaşabilir:

• LinkedIn — rozeti LinkedIn akışlarında paylaşır (kimlik bilgisini doğrudan profile eklemek için bunun yerine kimlik bilgisi sayfasındaki Add to LinkedIn profile düğmesini kullanın)
• Twitter / X — rozet bağlantısı ve özel paylaşım metniyle bir tweet gönderir
• Facebook — Facebook zaman tünelinde 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 çok alıcıya şık bir e-posta ileten sayfa içi bir pencere açar (aşağıdaki E-posta ile Paylaşım bölümüne bakın)
• Copy Link — doğrulama URL'sini panoya kopyalar
• Gömme kodları — rozeti bir web sitesine, intranete veya e-posta imzasına eklemek için yapıştırmaya hazır <img> ve <iframe> HTML'ini kopyalayın

QR ile Doğrulama

Özel bir doğrulama sayfası, kendi URL'sine işaret eden taranabilir bir QR kodu gösterir — basılı sertifikalar, etkinlik afişleri veya LinkedIn ekran görüntüleri için idealdir.

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

QR kodu telefon kamerasıyla tarayan herkes canlı doğrulama sayfasına ulaşır ve rozetin badges.ninja üzerinde barındırıldığını ve Open Badge v2.0 şartnamesine uyduğunu doğrulayabilir. Alıcı kimliği SHA-256 özeti olarak gösterilir, böylece e-postalar hiçbir zaman herkese açık şekilde ifşa edilmez.

PDF Sertifikası

Her kimlik bilgisi, yazdırmaya hazır bir A4 PDF sertifikası olarak indirilebilir. Sertifika seçeneği, herkese açık kimlik bilgisi sayfasındaki (/awards/{guid}) Download açılır menüsünde yer alır — yalnızca taranabilir QR kodunu ve ham Open Badge JSON'unu içeren doğrulama sayfasında değil. Seçildiğinde PDF, rozet görseli, alıcı adı, düzenleyen, ölçütler, veriliş tarihi, isteğe bağlı son kullanma tarihi ve canlı doğrulama URL'sine bağlanan bir QR koduyla anında (/certify-badge/award/{guid}/pdf adresinde) oluşturulur.

Sosyal Medya Önizlemeleri

Bir rozet bağlantısı LinkedIn, X, Slack, Facebook, WhatsApp veya e-postada paylaşıldığında platform paylaşım endpoint'ini çeker ve badges.ninja'nın ürettiği Open Graph meta verisinden zengin bir kart oluşturur:

• Önizleme görseli olarak rozet görseli
• Başlık olarak rozet adı
• Açıklamada düzenleyen adı ve alıcı adı

Bu sayede rozetler nerede paylaşılırsa paylaşılsın profesyonel görünür — alıcıların kendi görsellerini eklemesi veya metin yazması gerekmez. Önizleme sunucu tarafında /certify-badge/award/{guid}/share-html adresinde üretilir ve CDN uç noktasında önbelleğe alınır; böylece önizlemeler ilk paylaşımda bile anında görünür.

E-posta ile Paylaşım

Kimlik bilgilerini e-postayla iki şekilde gönderebilirsiniz:

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

Alıcılar, paylaşım sayfasında Send Email'e tıklayarak rozetlerini arkadaşları, mentorları veya olası işverenleriyle paylaşabilir. Bir pencere açılır; burada bir veya daha fazla e-posta adresi, isteğe bağlı bir konu ve kişisel bir mesaj girerler:

Her adres sahibi, alıcının kişisel mesajını ve herkese açık kimlik bilgisi sayfasını görüntülemek için tek tıklık bir düğmeyi içeren şık bir HTML e-posta alır:

Panodan

Düzenleyenler, panodaki Kimlik Bilgileri sayfasından herhangi bir kimlik bilgisini e-postayla gönderebilir:

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

Her iki akışta da aynı e-posta şablonu kullanılır.

Open Badge v2.0 JSON Endpoint'leri

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

Endpoint	Açıklama
/certify-badge/issuer/{guid}	Düzenleyen profili JSON'u
/certify-badge/badge/{guid}	BadgeClass JSON'u
/certify-badge/award/{guid}	Assertion JSON'u (kimlik bilgisi)

Bu endpoint'ler Open Badge v2.0 şartnamesiyle uyumlu JSON-LD döndürür. Diğer rozet platformları ve doğrulayıcılar bu veriyi kimlik bilgilerini doğrulamak için kullanabilir.

Örnek — bir kimlik bilgisini doğrulama:

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

Rozet Görseli URL'leri

Rozet görselleri Amazon S3'te saklanır ve küresel CDN'imiz üzerinden, görsel baytlarının kriptografik özetinden (SHA-256) türetilen içerik adreslemeli, değiştirilemez bir URL altında sunulur. Bu şu anlama gelir:

• Görseller kalıcı ve içerik adreslemelidir — URL baytların kendisinden türetildiği için görseller değiştirilemez veya fark edilmeden başkasıyla değiştirilemez
• Open Badge JSON'undaki görsel URL'leri https://badges.ninja/images/{sha256}.png biçimindedir
• Görseller CDN uç noktasından sunulur; dünyanın her yerinde hızlı yüklenir ve kimlik bilgisinin ömrü boyunca erişilebilir kalır

Görsel Open Badge assertion'ının bir parçası olduğundan, rozet tasarımını sonradan değiştirmek daha önce verilmiş kimlik bilgilerini bozmaz: özgün görselin kendi içerik adreslemeli URL'si korunur; dolayısıyla yeni verilişler için rozeti yeniden tasarlasanız bile geçmiş kimlik bilgileri özgün görsellerini korur.