Skip to content

Споделяне и верификация ​

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

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

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

Публична страница на сертификата ​

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

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

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

Public credential page

Страницата на сертификата винаги показва бутон Добави към профила в LinkedIn, за да може получателят да запази сертификата директно в „Лицензи и сертификати“ в LinkedIn. (Ако издателят е задал ID на организация в LinkedIn, LinkedIn попълва предварително потвърдената фирмена страница; в противен случай се използва името на издателя.) Едно падащо меню Изтегляне предлага две опции: Изображение на значката (оригиналният PNG) и Сертификат (A4 PDF за печат, генериран в движение на /certify-badge/award/{guid}/pdf).

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

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

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

Public share page with social buttons + embed snippets

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

  • LinkedIn — публикува значката в лентата им в LinkedIn (за да добавите сертификата директно към профила, използвайте бутона Добави към профила в LinkedIn на страницата на сертификата)
  • Twitter / X — публикува туит с връзката към значката и персонализиран текст
  • Facebook — споделя във Facebook профила им
  • WhatsApp — изпраща съобщение с връзката към значката
  • Telegram — изпраща съобщение с връзката към значката
  • Изпрати имейл — отваря модален прозорец, който доставя стилизиран имейл на един или повече получатели (вижте Споделяне по имейл по-долу)
  • Копирай връзката — копира URL адреса за верификация в клипборда
  • Код за вграждане — копирайте готов HTML код с <img> и <iframe>, за да поставите значката в уебсайт, интранет или имейл подпис

QR верификация ​

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

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

QR verification page with badge identity and scannable QR code

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

PDF сертификат ​

Всеки сертификат може да бъде изтеглен като A4 PDF сертификат, готов за печат. Опцията Сертификат е в падащото меню Изтегляне на публичната страница на сертификата (/awards/{guid}) — не на страницата за верификация, която съдържа само QR кода за сканиране и суровия JSON на Open Badge. Изборът ѝ генерира PDF в движение (на /certify-badge/award/{guid}/pdf) с изображението на значката, името на получателя, издателя, критериите, датата на издаване, по избор срока на валидност и QR код, водещ обратно към актуалния URL адрес за верификация.

Визуализации в социалните мрежи ​

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

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

How a shared badge link renders as a social-media preview card

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

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

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

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

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

In-page send email modal — recipients enter addresses, subject, and a personal note

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

The actual email each addressee receives

От таблото ​

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

  1. Намерете сертификата на страницата „Сертификати“.
  2. Щракнете върху бутона Изпрати в реда или отворете прозореца с подробности и щракнете върху Изпрати имейла отново.
  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. Други платформи за значки и верификатори могат да използват тези данни, за да валидират сертификати.

Пример — верификация на сертификат:

bash
curl https://api.badges.ninja/certify-badge/award/abc123-def456
json
{
  "@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 адрес, така че историческите сертификати запазват оригиналното си изображение, дори ако преработите дизайна на значката за нови издавания.

badges.ninja Documentation