Распространение и проверка

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

У получателей тоже есть собственный портал

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

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

У каждой награды есть публичный URL:

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

На этой странице отображаются изображение значка (загружаемое из IPFS), название и описание значка, имя получателя, название и логотип эмитента, дата выдачи и возможная дата истечения, а также критерии, которые получатель выполнил, чтобы заслужить значок. Любой человек со ссылкой может открыть страницу и убедиться в подлинности учётных данных.

Если эмитент указал ID организации LinkedIn, появляется кнопка Add to LinkedIn profile, чтобы получатель мог сохранить учётные данные прямо в раздел Licenses & Certifications своего LinkedIn. Кнопка Download Badge отдаёт оригинальное изображение значка (прямо из IPFS), а Download PDF на лету генерирует готовый к печати сертификат формата A4.

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

Страница распространения предлагает варианты публикации в социальных сетях:

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

С этой страницы получатели могут поделиться своим значком в:

• LinkedIn — публикует запись в ленте LinkedIn или добавляет учётные данные прямо в профиль через кнопку Add to LinkedIn Profile (когда эмитент указал ID организации 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 или по электронной почте, платформа запрашивает share-эндпоинт и отображает богатую карточку на основе метаданных Open Graph, которые отдаёт badges.ninja:

• Изображение значка в качестве превью-картинки
• Название значка в качестве заголовка
• Название эмитента и имя получателя в описании

Это гарантирует, что значки выглядят профессионально при публикации где угодно — получателям не нужно прикреплять собственное изображение или писать текст. Превью генерируется на сервере по адресу /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 по этим публичным эндпоинтам:

Эндпоинт	Описание
/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}
• Тот же content-ID разрешается через любой публичный IPFS-шлюз (cloudflare-ipfs.com, ipfs.io и др.) — ваши значки не привязаны к одному поставщику

Поскольку изображение является частью Open Badge assertion, замена графики значка позже не ломает уже выданные награды: старый CID в IPFS остаётся доступным навсегда, поэтому исторические награды сохраняют своё оригинальное изображение, даже если вы переработаете дизайн значка для новых выдач.