Поширення та перевірка

Кожна нагорода на badges.ninja має публічну сторінку перевірки, до якої будь-хто може отримати доступ без входу в систему. Одержувачі можуть ділитися своїми значками в соціальних мережах, електронною поштою або копіюючи пряме посилання.

В одержувачів теж є власний портал

Якщо ви отримали значок через badges.ninja, ви можете увійти (без пароля) за адресою badges.ninja/me, щоб переглянути всі свої значки в одному місці та налаштувати публічний профіль за адресою badges.ninja/u/<ваш-нікнейм>. Див. Портал одержувача.

Публічна сторінка нагороди

Кожна нагорода має публічну URL-адресу:

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

На цій сторінці відображається зображення значка (завантажується з IPFS), назва й опис значка, ім'я одержувача, назва і логотип емітента, дата видачі та можлива дата завершення дії, а також критерії, яким одержувач відповідав, щоб заслужити значок. Будь-хто з посиланням може відкрити сторінку, щоб переконатися в автентичності облікових даних.

Якщо емітент задав ідентифікатор організації LinkedIn, з'являється кнопка Додати до профілю LinkedIn, що дозволяє одержувачу зберегти облікові дані безпосередньо в розділі Licenses & Certifications своєї сторінки LinkedIn. Кнопка Завантажити значок видає оригінальне зображення значка (безпосередньо з IPFS), а Завантажити PDF генерує сертифікат формату A4, готовий до друку, на льоту.

Публічна сторінка поширення

Сторінка поширення надає опції соціального обміну:

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

З цієї сторінки одержувачі можуть поділитися своїм значком на:

• LinkedIn — публікує у стрічці LinkedIn або додає облікові дані безпосередньо до профілю через кнопку Add to LinkedIn Profile (коли емітент задав ідентифікатор організації LinkedIn)
• Twitter / X — публікує твіт із посиланням на значок та власним текстом поширення
• Facebook — публікує на хроніці Facebook
• WhatsApp — надсилає повідомлення з посиланням на значок
• Telegram — надсилає повідомлення з посиланням на значок
• Send Email — відкриває модальне вікно на сторінці, яке надсилає стилізований лист одному або багатьом одержувачам (див. Поширення електронною поштою нижче)
• Copy Link — копіює URL перевірки в буфер обміну
• Embed snippets — копіює готові до вставки HTML-фрагменти <img> та <iframe>, щоб додати значок на вебсайт, в інтранет або в підпис електронного листа

Перевірка через QR-код

Спеціальна сторінка перевірки відображає скануваний QR-код, що вказує на її власну URL-адресу — ідеально для друкованих сертифікатів, банерів заходів або скріншотів LinkedIn.

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

Будь-хто, хто сканує QR камерою телефону, потрапляє на живу сторінку перевірки, де може переконатися, що значок розміщений на badges.ninja, відповідає специфікації Open Badge v2.0 та (у плані Pro) закріплений у блокчейні через Matchain. Ідентичність одержувача показана як хеш SHA-256, тому електронні адреси ніколи не розкриваються публічно.

PDF-сертифікат

Кожна нагорода має кнопку Download Certificate на публічній сторінці перевірки. Натискання генерує на льоту готовий до друку PDF формату A4, що містить зображення значка, ім'я одержувача, емітента, критерії, дату видачі, опціональну дату завершення дії та QR-код, який повертає до живої URL перевірки.

Превʼю в соціальних мережах

Коли посилання на значок поширюється у LinkedIn, X, Slack, Facebook, WhatsApp або електронною поштою, платформа отримує endpoint поширення та формує насичену картку з метаданих Open Graph, які видає badges.ninja:

• Зображення значка як превʼю-зображення
• Назва значка як заголовок
• Назва емітента та імʼя одержувача в описі

Це гарантує, що значки виглядають професійно скрізь, де ними діляться — одержувачам не потрібно прикріплювати власне зображення чи писати текст. Превʼю генерується на сервері за адресою /certify-badge/award/{guid}/share-html та кешується на CDN-границі, тож превʼю зʼявляються миттєво навіть під час першого поширення.

Поширення електронною поштою

Ви можете надсилати нагороди-значки електронною поштою двома способами:

З публічної сторінки поширення

Одержувачі можуть поділитися своїм значком з друзями, наставниками чи потенційними роботодавцями, натиснувши Send Email на сторінці поширення. Відкриється модальне вікно, де вони вводять одну чи кілька електронних адрес, опціональну тему та особисте повідомлення:

Кожен адресат отримує стилізований HTML-лист з особистим повідомленням одержувача та кнопкою одного кліку для перегляду публічної сторінки нагороди:

З панелі управління

Емітенти можуть надіслати будь-яку нагороду електронною поштою зі сторінки Awards у панелі управління:

1. Знайдіть нагороду на сторінці Awards.
2. Натисніть кнопку Send у рядку або відкрийте модальне вікно деталей і натисніть Resend email.
3. Введіть e-mail одержувача та надішліть.

Той самий шаблон листа використовується для обох сценаріїв.

JSON-ендпоінти Open Badge v2.0

Для сумісності з іншими платформами значків badges.ninja надає стандартний JSON Open Badge v2.0 за такими публічними ендпоінтами:

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

Ці ендпоінти повертають 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"
  }
}

URL-адреси зображень в IPFS

Зображення значків закріплюються в IPFS (InterPlanetary File System) через наш власний шлюз ipfs.ninja. Це означає:

• Зображення є постійними та адресованими за вмістом — їх неможливо підробити або тихо замінити
• URL-адреси зображень у JSON Open Badge виглядають як https://ipfs.ninja/ipfs/{cid}
• Той самий ідентифікатор вмісту вирішується через будь-який публічний шлюз IPFS (cloudflare-ipfs.com, ipfs.io тощо) — ваші значки не привʼязані до одного провайдера

Оскільки зображення є частиною твердження Open Badge, заміна графіки значка пізніше не порушує раніше виданих нагород: старий CID IPFS залишається вирішуваним назавжди, тож історичні нагороди зберігають своє оригінальне зображення, навіть якщо ви переробите значок для нових видач.