Udostępnianie i weryfikacja

Każde poświadczenie w badges.ninja ma publiczną stronę weryfikacji, do której każdy może wejść bez logowania. Odbiorcy mogą udostępniać swoje cyfrowe odznaki w mediach społecznościowych, e-mailem lub przez skopiowanie bezpośredniego linku.

Odbiorcy mają też własny portal

Jeśli zdobyłeś odznakę dzięki badges.ninja, możesz zalogować się (bez hasła) na badges.ninja/me, aby zobaczyć wszystkie swoje odznaki w jednym miejscu i stworzyć publiczny profil pod adresem badges.ninja/u/<your-handle>. Zobacz Portal odbiorcy.

Publiczna strona poświadczenia

Każde poświadczenie ma publiczny adres URL:

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

Ta strona wyświetla obraz odznaki, jej nazwę i opis, imię i nazwisko odbiorcy, nazwę i logo wystawcy, datę wystawienia oraz ewentualną datę ważności, a także kryteria, które odbiorca spełnił, aby zdobyć odznakę. Każdy, kto ma link, może otworzyć stronę i potwierdzić autentyczność poświadczenia.

Strona poświadczenia zawsze pokazuje przycisk Dodaj do profilu LinkedIn, dzięki któremu odbiorca może zapisać poświadczenie bezpośrednio w sekcji Licencje i certyfikaty na LinkedIn. (Jeśli wystawca ustawił identyfikator organizacji LinkedIn, LinkedIn automatycznie uzupełnia zweryfikowaną stronę firmy; w przeciwnym razie używa nazwy wystawcy.) Jedno menu Pobierz oferuje dwie opcje: Obraz odznaki (oryginalny plik PNG) oraz Certyfikat (gotowy do wydruku plik PDF w formacie A4, generowany na bieżąco pod adresem /certify-badge/award/{guid}/pdf).

Publiczna strona udostępniania

Strona udostępniania oferuje opcje publikacji w mediach społecznościowych:

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

Na tej stronie odbiorcy mogą udostępnić odznakę w:

• LinkedIn — publikuje odznakę w aktualnościach na LinkedIn (aby dodać poświadczenie bezpośrednio do profilu, użyj zamiast tego przycisku Dodaj do profilu LinkedIn na stronie poświadczenia)
• Twitter / X — publikuje tweeta z linkiem do odznaki i własnym tekstem
• Facebook — udostępnia na osi czasu na Facebooku
• WhatsApp — wysyła wiadomość z linkiem do odznaki (np. w WhatsAppie)
• Telegram — wysyła wiadomość z linkiem do odznaki
• Wyślij e-mail — otwiera okno modalne na stronie, które dostarcza stylizowany e-mail do jednego lub wielu adresatów (zobacz Udostępnianie e-mailem poniżej)
• Kopiuj link — kopiuje adres URL weryfikacji do schowka
• Fragmenty do osadzenia — skopiuj gotowy kod HTML <img> i <iframe>, aby wstawić odznakę na stronę internetową, do intranetu lub do podpisu e-mail

Weryfikacja kodem QR

Dedykowana strona weryfikacji wyświetla kod QR do zeskanowania, który wskazuje na jej własny adres URL — idealny na drukowane certyfikaty, banery wydarzeń lub zrzuty ekranu z LinkedIn.

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

Osoba, która zeskanuje kod QR aparatem telefonu, trafia na aktualną stronę weryfikacji, gdzie może potwierdzić, że odznaka jest hostowana na badges.ninja i jest zgodna ze specyfikacją Open Badge v2.0. Tożsamość odbiorcy jest wyświetlana jako skrót SHA-256, więc adresy e-mail nigdy nie są publicznie ujawniane.

Certyfikat PDF

Każde poświadczenie można pobrać jako gotowy do wydruku certyfikat PDF w formacie A4. Opcja Certyfikat znajduje się w menu Pobierz na publicznej stronie poświadczenia (/awards/{guid}) — a nie na stronie weryfikacji, która zawiera wyłącznie kod QR do zeskanowania i surowy JSON Open Badge. Po jej wybraniu plik PDF jest generowany na bieżąco (pod adresem /certify-badge/award/{guid}/pdf) i zawiera obraz odznaki, imię i nazwisko odbiorcy, wystawcę, kryteria, datę wystawienia, opcjonalną datę ważności oraz kod QR prowadzący do aktualnego adresu URL weryfikacji.

Podglądy w mediach społecznościowych

Gdy link do odznaki jest udostępniany na LinkedIn, X, Slacku, Facebooku, w WhatsAppie lub e-mailem, platforma pobiera endpoint udostępniania i wyświetla bogatą kartę na podstawie metadanych Open Graph generowanych przez badges.ninja:

• Obraz odznaki jako obraz podglądu
• Nazwa odznaki jako tytuł
• Nazwa wystawcy i imię i nazwisko odbiorcy w opisie

Dzięki temu odznaki wyglądają profesjonalnie wszędzie, gdzie są udostępniane — odbiorcy nie muszą dołączać własnego obrazu ani pisać tekstu. Podgląd jest generowany po stronie serwera pod adresem /certify-badge/award/{guid}/share-html i buforowany na brzegu CDN, więc pojawia się natychmiast, nawet przy pierwszym udostępnieniu.

Udostępnianie e-mailem

Poświadczenia możesz wysyłać e-mailem na dwa sposoby:

Z publicznej strony udostępniania

Odbiorcy mogą udostępnić odznakę znajomym, mentorom lub potencjalnym pracodawcom, klikając Wyślij e-mail na stronie udostępniania. Otwiera się okno modalne, w którym wpisują jeden lub więcej adresów e-mail, opcjonalny temat i osobistą wiadomość:

Każdy adresat otrzymuje stylizowany e-mail HTML z osobistą wiadomością nadawcy i przyciskiem, który jednym kliknięciem otwiera publiczną stronę poświadczenia:

Z panelu

Wystawcy mogą wysłać dowolne poświadczenie e-mailem ze strony Poświadczenia w panelu:

1. Znajdź poświadczenie na stronie Poświadczenia.
2. Kliknij przycisk Wyślij w wierszu lub otwórz okno szczegółów i kliknij Wyślij e-mail ponownie.
3. Wpisz adres e-mail odbiorcy i wyślij.

W obu przypadkach używany jest ten sam szablon e-maila.

Endpointy JSON Open Badge v2.0

Aby zapewnić interoperacyjność z innymi platformami odznak, badges.ninja udostępnia standardowy JSON Open Badge v2.0 pod tymi publicznymi endpointami:

Endpoint	Opis
/certify-badge/issuer/{guid}	JSON profilu wystawcy
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (poświadczenie)

Te endpointy zwracają JSON-LD zgodny ze specyfikacją Open Badge v2.0. Inne platformy odznak i weryfikatory mogą wykorzystać te dane do walidacji poświadczeń.

Przykład — weryfikacja poświadczenia:

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

Adresy URL obrazów odznak

Obrazy odznak są przechowywane w Amazon S3 i udostępniane przez naszą globalną sieć CDN pod niezmiennym adresem URL opartym na zawartości, wyprowadzonym z kryptograficznego skrótu (SHA-256) bajtów obrazu. Oznacza to, że:

• Obrazy są trwałe i adresowane przez zawartość — adres URL wynika z samych bajtów, więc nie można ich zmodyfikować ani po cichu podmienić
• Adresy URL obrazów w JSON Open Badge wyglądają tak: https://badges.ninja/images/{sha256}.png
• Obrazy są serwowane z brzegu CDN, dzięki czemu ładują się szybko w dowolnym miejscu na świecie i pozostają dostępne przez cały okres życia poświadczenia

Ponieważ obraz jest częścią assertion Open Badge, późniejsza zmiana grafiki odznaki nie unieważnia wcześniej wystawionych poświadczeń: oryginalny obraz zachowuje własny adres URL oparty na zawartości, więc dotychczasowe poświadczenia zachowują pierwotny obraz, nawet jeśli przeprojektujesz odznakę dla nowych wystawień.