Споделяне и удостоверяване

Всяка награда в badges.ninja има публична страница за удостоверяване, която всеки може да отвори, без да влиза в профила си. Получателите могат да споделят значките си в социалните мрежи, по имейл или като копират директна връзка.

Получателите също имат собствен портал

Ако сте спечелили значка чрез badges.ninja, можете да влезете (без парола) на адрес badges.ninja/me, за да видите всичките си значки на едно място и да си изградите публичен профил на адрес badges.ninja/u/<вашият-handle>. Вижте Портал на получателя.

Публична страница на наградата

Всяка награда има публичен URL:

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

Тази страница показва изображението на значката (заредено от IPFS), името и описанието на значката, името на получателя, името и логото на издателя, датата на издаване и евентуалната дата на изтичане, както и критериите, които получателят е изпълнил, за да заслужи значката. Всеки с връзката може да отвори страницата и да потвърди, че удостоверението е автентично.

Ако издателят е задал LinkedIn organization ID, се появява бутонът Add to LinkedIn profile, така че получателят да може да запази удостоверението директно в своя раздел LinkedIn Licenses & Certifications. Бутонът Download Badge предоставя оригиналното изображение на значката (директно от IPFS), а Download PDF генерира в реално време готов за печат A4 сертификат.

Публична страница за споделяне

Страницата за споделяне предлага опции за социално разпространение:

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

От тази страница получателите могат да споделят значката си в:

• LinkedIn — публикува във feed-а им в LinkedIn или добавя удостоверението директно в профила им чрез бутона Add to LinkedIn Profile (когато издателят е задал LinkedIn organization ID)
• Twitter / X — публикува туит с връзката към значката и персонализиран текст за споделяне
• Facebook — споделя във времевата им линия във Facebook
• WhatsApp — изпраща съобщение с връзката към значката
• Telegram — изпраща съобщение с връзката към значката
• Send Email — отваря модален прозорец в страницата, който изпраща стилизиран имейл до един или повече получатели (вижте Споделяне по имейл по-долу)
• Copy Link — копира URL за удостоверяване в клипборда
• Embed snippets — копира готови за поставяне <img> и <iframe> HTML фрагменти, за да добавите значката в уебсайт, интранет или подпис на имейл

QR удостоверяване

Специална страница за удостоверяване визуализира сканируем QR код, сочещ към собствения си URL — идеално за печатни сертификати, банери на събития или скрийншоти за LinkedIn.

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

Всеки, който сканира QR кода с камерата на телефона си, попада на живата страница за удостоверяване, където може да потвърди, че значката се хоства на badges.ninja, следва спецификацията Open Badge v2.0 и (на план Pro) е закотвена on-chain чрез Matchain. Самоличността на получателя се показва като SHA-256 хеш, така че имейлите никога не се излагат публично.

PDF сертификат

Всяка награда има бутон Download Certificate на публичната страница за удостоверяване. Кликването му генерира в реално време готов за печат A4 PDF, който включва изображението на значката, името на получателя, издателя, критериите, датата на издаване, евентуална дата на изтичане и QR код, водещ обратно към живата страница за удостоверяване.

Прегледи в социалните мрежи

Когато връзка към значка се сподели в LinkedIn, X, Slack, Facebook, WhatsApp или имейл, платформата извлича share endpoint-а и визуализира богата карта от Open Graph метаданните, които badges.ninja излъчва:

• Изображението на значката като preview изображение
• Името на значката като заглавие
• Името на издателя и името на получателя в описанието

Това гарантира, че значките изглеждат професионално, където и да се споделят — получателите не трябва да прикачват собствено изображение или да пишат текст. Прегледът се генерира от страна на сървъра на адрес /certify-badge/award/{guid}/share-html и се кешира в edge на CDN, така че прегледите се появяват мигновено дори при първото споделяне.

Споделяне по имейл

Можете да изпращате значки по имейл по два начина:

От публичната страница за споделяне

Получателите могат да споделят значката си с приятели, ментори или потенциални работодатели, като кликнат на Send Email в страницата за споделяне. Отваря се модален прозорец, в който въвеждат един или повече имейл адреси, незадължителна тема и персонално съобщение:

Всеки адресат получава стилизиран HTML имейл с личното съобщение на получателя и бутон с едно кликване за разглеждане на публичната страница на наградата:

От таблото за управление

Издателите могат да изпратят всяка награда по имейл от страницата Awards в таблото:

1. Намерете наградата на страницата Awards.
2. Кликнете на бутона Send на реда или отворете детайлния модален прозорец и кликнете на Resend email.
3. Въведете имейла на получателя и изпратете.

Същият имейл шаблон се използва и за двата потока.

JSON крайни точки на Open Badge v2.0

За съвместимост с други платформи за значки, badges.ninja предоставя стандартен Open Badge v2.0 JSON на следните публични endpoint-и:

Endpoint	Описание
/certify-badge/issuer/{guid}	JSON на профила на издателя
/certify-badge/badge/{guid}	JSON на BadgeClass
/certify-badge/award/{guid}	JSON на Assertion (наградата)

Тези endpoint-и връщат JSON-LD, съвместим със спецификацията Open Badge v2.0. Други платформи за значки и верификатори могат да използват тези данни, за да валидират удостоверения.

Пример — удостоверете награда:

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 URL адреси на изображения

Изображенията на значките се пинват в IPFS (the InterPlanetary File System) през нашия собствен gateway, ipfs.ninja. Това означава:

• Изображенията са постоянни и адресирани по съдържание — не могат да бъдат подправени или тихо заменени
• URL адресите на изображенията в Open Badge JSON изглеждат като https://ipfs.ninja/ipfs/{cid}
• Същият content-ID се резолвира през всеки публичен IPFS gateway (cloudflare-ipfs.com, ipfs.io и др.) — вашите значки не са заключени към един доставчик

Тъй като изображението е част от Open Badge assertion, замяната на дизайна на значката по-късно не нарушава вече издадените награди: старият IPFS CID остава резолваем завинаги, така че историческите награди запазват оригиналното си изображение, дори ако препроектирате значката за нови издавания.