Разработчикам

Open Badges для разработчиков

Техническая документация для разработчиков платформ. Как выдавать, отображать и хранить бейджи по открытой спецификации Open Badges на JSON-LD.

Модель данных

Связанные ресурсы (JSON-LD)

Экосистема базируется на графовой модели данных (Linked Data). Для валидной эмиссии требуется публикация трёх взаимосвязанных JSON-LD сущностей, адресуемых через абсолютные URL.

Profile

Сущность эмитента

Корневой JSON-LD документ, идентифицирующий организацию-эмитента. Содержит контактные данные, реквизиты и метод верификации (URL хоста или, опционально, публичный ключ). Все дочерние сущности ссылаются на Profile.

BadgeClass

Модель компетенции

Абстрактное описание достижения. Включает графический эталон (image), детальные критерии получения (criteria URI), теги и параметры выравнивания по внешним профстандартам (Alignment).

Assertion

Экземпляр сертификата

Конкретный экземпляр выданного бейджа, привязывающий BadgeClass к определённому получателю. Содержит дату выдачи, ссылки на артефакты (Evidence) и данные для верификации (URL или JWS-подпись).

Про baking

Baking — это процесс внедрения URL Assertion (или полного JSON) в метаданные графического файла (PNG tEXt/iTXt chunk или SVG metadata). Это позволяет переносить бейдж как обычное изображение, сохраняя в нём всю информацию для последующей верификации.

Управление

Управление стандартом

Спецификация Open Badges открыта и бесплатна для реализации. Разрабатывает и поддерживает стандарт консорциум 1EdTech, объединяющий крупнейшие образовательные и технологические организации.

Подробнее об истории стандарта и версиях спецификации — на странице О стандарте.

Реализация

Что нужно реализовать

Три базовые задачи, которые решает любая платформа, работающая с Open Badges.

Генерация метаданных

Формирование JSON-LD документов (Profile, BadgeClass, Assertion) в соответствии со схемами спецификации Open Badges.

Верификация подлинности

Реализация механизма проверки: hosted verification (проверка по URL) или опциональная signed verification (JWS-подпись).

Интероперабельность

Разработка API для обмена цифровыми достижениями между LMS, HR-системами и внешними платформами.

Свойства

Опциональные свойства

01

Критерии (Criteria URI)

Абсолютная ссылка на публичную страницу с изложением образовательных метрик достижения.

02

Валидация (Verification)

Встроенный механизм проверки статуса «отозван» (Revocation List) по протоколу OBI.

03

Выравнивание (Alignment)

Маппинг на глобальные классификаторы ESCO, O*NET или национальные рамки квалификаций.

04

i18n (Локализация)

Поддержка свойств @language из стандарта JSON-LD для мультиязычного отображения свойств.

05

Доказательства (Evidence)

Массив ссылок на внешние артефакты (репозитории, видео, проекты), подтверждающие навыки.

Подтверждения (Endorsements)

Спецификация 3.0 вводит механизм Endorsements — структурированные заявления от третьих лиц о валидности конкретного BadgeClass, Assertion или самого Issuer.

Это позволяет выстраивать цепочки доверия, где ценность сертификата подкрепляется независимыми экспертными организациями или партнёрами.

Пример цепочки доверия

Государственный регулятор (Issuer A) выпускает Endorsement-объект в сторону платформы университета (Issuer B), подтверждая легитимность её бейджей (BadgeClass) о высшем образовании.

Расширения

Схемы расширений (Extensions)

Open Badges — расширяемый стандарт. Используя пространства имён JSON-LD, платформы могут добавлять собственные данные в структуру бейджа, сохраняя совместимость со спецификацией и обратную совместимость. Существуют официально одобренные 1EdTech (IMS Extensions) и созданные сообществом структуры.

  • Issuer Accreditation (Лицензирование эмитента)
  • Assessment (Метрики оценивания, баллы)
  • Extra Description (Расширенные метаданные)
  • Geo Location (Гео-привязка сертификата)
  • Accessibility (Поддержка доступности)
  • Creative Commons License (Лицензии на контент)
  • Original Creator (Авторская атрибуция)

Видеоразбор

Вебинар: взаимодействие Issuer, Displayer и Host

30-минутный разбор интеграционной схемы для разработчиков, готовящих инфраструктуру к сертификации OBI Conformant.

Смотреть вебинар
Технические участники

Три участника в технике

В спецификации роли описаны отдельно от пользовательских ролей: одну и ту же платформу разработчик может реализовать как несколько технических участников сразу.

Эмитент

(Issuer)

Серверное приложение, публикующее JSON-LD документы (Profile, BadgeClass, Assertion). Формирует и размещает бейджи, обеспечивая их доступность для верификации по URL или через подпись (JWS).

Клиентское приложение

(Displayer)

LMS, HR-система, интранет или соцсеть. Извлекает метаданные из запечённых PNG/SVG файлов, проверяет подлинность бейджа (по URL или подписи) и отображает информацию о достижении.

Кошелёк

(Host / Backpack)

Цифровой кошелёк обладателя. Хранилище для агрегации, категоризации и управления доступом к коллекции полученных бейджей.

Команда поддержки

Внедрить Open Badges

Напишите команде, если нужна помощь с интеграцией Open Badges в вашу платформу, или сразу открывайте документацию спецификации.