Udostępnianie i weryfikacja

Każde wyróżnienie na badges.ninja ma publiczną stronę weryfikacyjną, do której każdy może uzyskać dostęp bez logowania. Odbiorcy mogą udostępniać swoje odznaki w mediach społecznościowych, e-mailem lub kopiując bezpośredni link.

Odbiorcy mają również własny portal

Jeśli zdobyłeś odznakę poprzez 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/<twój-uchwyt>. Zobacz Portal odbiorcy.

Publiczna strona wyróżnienia

Każde wyróżnienie ma publiczny adres URL:

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

Ta strona wyświetla obraz odznaki (załadowany z IPFS), nazwę i opis odznaki, imię odbiorcy, nazwę i logo wystawcy, datę wystawienia oraz ewentualną datę wygaśnięcia, a także kryteria, które odbiorca spełnił, aby zdobyć odznakę. Każda osoba posiadająca link może otworzyć stronę i potwierdzić, że poświadczenie jest autentyczne.

Jeśli wystawca ustawił identyfikator organizacji LinkedIn, pojawi się przycisk Add to LinkedIn profile, aby odbiorca mógł zapisać poświadczenie bezpośrednio w swojej sekcji LinkedIn Licencje i certyfikaty. Przycisk Download Badge dostarcza oryginalny obraz odznaki (prosto z IPFS), a Download PDF generuje na bieżąco gotowy do druku certyfikat A4.

Publiczna strona udostępniania

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

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

Z tej strony odbiorcy mogą udostępniać swoją odznakę na:

• LinkedIn — publikuje wpis w kanale LinkedIn lub dodaje poświadczenie bezpośrednio do profilu poprzez przycisk Add to LinkedIn Profile (gdy wystawca ustawił identyfikator organizacji LinkedIn)
• Twitter / X — publikuje tweet z linkiem do odznaki i niestandardowym tekstem udostępniania
• Facebook — udostępnia na osi czasu Facebook
• WhatsApp — wysyła wiadomość z linkiem do odznaki
• Telegram — wysyła wiadomość z linkiem do odznaki
• Send Email — otwiera modal w stronie, który dostarcza stylizowany e-mail do jednego lub wielu odbiorców (zobacz Udostępnianie przez e-mail poniżej)
• Copy Link — kopiuje URL weryfikacji do schowka
• Embed snippets — kopiuje gotowe do wklejenia fragmenty HTML <img> i <iframe>, aby umieścić odznakę na stronie internetowej, w intranecie lub w stopce e-mail

Weryfikacja QR

Dedykowana strona weryfikacyjna generuje skanowalny kod QR wskazujący na własny URL — idealny do drukowanych certyfikatów, banerów wydarzeń lub zrzutów ekranu LinkedIn.

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

Każdy, kto zeskanuje kod QR aparatem telefonu, trafia na stronę weryfikacji na żywo, gdzie może potwierdzić, że odznaka jest hostowana na badges.ninja, jest zgodna ze specyfikacją Open Badge v2.0 i (w planie Pro) jest zakotwiczona on-chain za pośrednictwem Matchain. Tożsamość odbiorcy jest pokazana jako skrót SHA-256, dzięki czemu adresy e-mail nigdy nie są publicznie ujawniane.

Certyfikat PDF

Każde wyróżnienie ma przycisk Download Certificate na publicznej stronie weryfikacyjnej. Kliknięcie go generuje na bieżąco gotowy do druku PDF A4, który zawiera obraz odznaki, imię odbiorcy, wystawcę, kryteria, datę wystawienia, opcjonalną datę wygaśnięcia oraz kod QR prowadzący z powrotem do żywego URL weryfikacji.

Podglądy w mediach społecznościowych

Gdy link do odznaki jest udostępniany na LinkedIn, X, Slack, Facebook, WhatsApp lub w e-mailu, platforma pobiera punkt końcowy udostępniania i renderuje bogatą kartę z metadanych Open Graph emitowanych przez badges.ninja:

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

Dzięki temu odznaki wyglądają profesjonalnie wszędzie tam, 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 krawędzi CDN, więc podglądy pojawiają się natychmiast nawet przy pierwszym udostępnieniu.

Udostępnianie przez e-mail

Wyróżnienia można wysyłać e-mailem na dwa sposoby:

Z publicznej strony udostępniania

Odbiorcy mogą udostępniać swoją odznakę znajomym, mentorom lub potencjalnym pracodawcom, klikając Send Email na stronie udostępniania. Otwiera się modal, w którym wprowadza się 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ą odbiorcy i przyciskiem jednego kliknięcia umożliwiającym wyświetlenie publicznej strony wyróżnienia:

Z panelu

Wystawcy mogą wysłać dowolne wyróżnienie e-mailem ze strony Awards w panelu:

1. Znajdź wyróżnienie na stronie Awards.
2. Kliknij przycisk Send w wierszu lub otwórz modal szczegółów i kliknij Resend email.
3. Wprowadź adres e-mail odbiorcy i wyślij.

W obu przepływach używany jest ten sam szablon e-maila.

Punkty końcowe JSON Open Badge v2.0

W celu interoperacyjności z innymi platformami odznak, badges.ninja udostępnia standardowy JSON Open Badge v2.0 w tych publicznych punktach końcowych:

Punkt końcowy	Opis
/certify-badge/issuer/{guid}	JSON profilu wystawcy
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (wyróżnienie)

Te punkty końcowe 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 — zweryfikuj wyróżnienie:

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 IPFS

Obrazy odznak są przypinane do IPFS (InterPlanetary File System) za pośrednictwem naszej własnej bramy ipfs.ninja. To oznacza:

• Obrazy są trwałe i adresowane treścią — nie można ich modyfikować ani po cichu zastępować
• Adresy URL obrazów w JSON Open Badge wyglądają tak: https://ipfs.ninja/ipfs/{cid}
• Ten sam identyfikator treści jest rozwiązywalny przez dowolną publiczną bramę IPFS (cloudflare-ipfs.com, ipfs.io itp.) — twoje odznaki nie są przywiązane do jednego dostawcy

Ponieważ obraz jest częścią deklaracji Open Badge, późniejsza wymiana grafiki odznaki nie psuje wcześniej wystawionych wyróżnień: stary CID IPFS pozostaje rozwiązywalny na zawsze, więc historyczne wyróżnienia zachowują swój oryginalny obraz, nawet jeśli przeprojektujesz odznakę dla nowych wystawień.