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

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

Одержувачі також мають власний портал

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

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

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

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

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

На сторінці посвідчення завжди є кнопка Add to LinkedIn profile, щоб одержувач міг зберегти посвідчення просто у свій розділ LinkedIn «Ліцензії та сертифікати». (Якщо емітент указав ідентифікатор організації LinkedIn, LinkedIn автоматично підставить верифіковану сторінку компанії; інакше буде використано назву емітента.) Єдиний випадний список Download пропонує два варіанти: Badge image (оригінальний PNG) і Certificate (PDF-файл формату A4 для друку, який створюється на льоту за адресою /certify-badge/award/{guid}/pdf).

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

Сторінка поширення пропонує способи поширення в соціальних мережах:

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

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

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

QR-верифікація

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

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

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

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

Кожне посвідчення можна завантажити як PDF-сертифікат формату A4, готовий до друку. Варіант Certificate розташований у випадному списку Download на публічній сторінці посвідчення (/awards/{guid}) — а не на сторінці верифікації, де є лише QR-код для сканування та необроблений JSON Open Badge. Після вибору цього варіанта PDF створюється на льоту (за адресою /certify-badge/award/{guid}/pdf) із зображенням значка, ім'ям одержувача, емітентом, критеріями, датою видачі, необов'язковою датою завершення дії та QR-кодом, що веде на актуальну URL-адресу верифікації.

Попередній перегляд у соціальних мережах

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

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

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

Надсилання електронною поштою

Надіслати посвідчення електронною поштою можна двома способами:

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

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

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

Із панелі керування

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

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

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

Кінцеві точки 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-адреси зображень значків

Зображення значків зберігаються в Amazon S3 і віддаються через нашу глобальну CDN за незмінною URL-адресою на основі вмісту, похідною від криптографічного хешу (SHA-256) байтів зображення. Це означає:

• Зображення постійні й адресуються за вмістом — URL-адреса походить від самих байтів, тому їх неможливо підмінити чи непомітно замінити
• URL-адреси зображень у JSON Open Badge мають вигляд https://badges.ninja/images/{sha256}.png
• Зображення віддаються з периферії CDN, тож швидко завантажуються в будь-якій точці світу й залишаються доступними весь строк дії посвідчення

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