Публикация и верификация

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

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

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

Публичная страница credential

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

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

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

На странице credential всегда есть кнопка Add to LinkedIn profile, с помощью которой получатель может сохранить credential прямо в раздел Licenses & Certifications своего профиля LinkedIn. (Если эмитент указал идентификатор организации LinkedIn, LinkedIn автоматически подставит верифицированную страницу компании; в противном случае используется название эмитента.) Единый выпадающий список Download предлагает два варианта: Badge image (исходный PNG) и Certificate (печатный PDF формата A4, создаваемый на лету по адресу /certify-badge/award/{guid}/pdf).

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

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

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

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

• LinkedIn — публикует значок в ленте LinkedIn (чтобы добавить credential прямо в профиль, используйте вместо этого кнопку Add to LinkedIn profile на странице credential)
• Twitter / X — публикует твит со ссылкой на значок и настраиваемым текстом
• Facebook — публикует на странице Facebook
• WhatsApp — отправляет сообщение со ссылкой на значок
• Telegram — отправляет сообщение со ссылкой на значок
• Send Email — открывает модальное окно на странице, которое отправляет стилизованное письмо одному или нескольким адресатам (см. Отправка по электронной почте ниже)
• Copy Link — копирует URL верификации в буфер обмена
• Фрагменты для встраивания — готовый к вставке HTML-код <img> и <iframe>, чтобы разместить значок на сайте, в интранете или в подписи электронного письма

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

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

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

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

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

Любой credential можно скачать в виде готового к печати PDF-сертификата формата A4. Вариант Certificate находится в выпадающем списке Download на публичной странице credential (/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, поэтому он появляется мгновенно даже при первой публикации.

Отправка по электронной почте

Отправить credential по электронной почте можно двумя способами:

Со страницы публикации

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

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

Из панели управления

Эмитенты могут отправить любой credential по электронной почте со страницы Credentials в панели управления:

1. Найдите credential на странице 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 (credential)

Эти конечные точки возвращают JSON-LD, соответствующий спецификации Open Badge v2.0. Другие платформы значков и средства верификации могут использовать эти данные для проверки credential.

Пример — верификация credential:

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, поэтому быстро загружаются в любой точке мира и остаются доступными в течение всего срока жизни credential

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