Применение · Разработчикам

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

Структура данных, выдача и отзыв, верификация и интеграция. Без воды — то, что нужно, чтобы начать работать со стандартом.

С точки зрения разработчика Open Badges — это набор JSON-документов с привязкой к проверке. Бейдж связывает три сущности: профиль эмитента, описание достижения и сам факт выдачи (assertion). В версии 2.0 объекты публикуются по URL, в версии 3.0 — оформляются как Verifiable Credentials и подписываются криптографически.

Объекты модели данных

Issuer / Profile
Кто выдаёт: id (URL), name, url, контактный email. Точка доверия всей цепочки.
Achievement / BadgeClass
Что выдаётся: name, description, criteria, image, теги навыков и согласования (alignment).
Assertion / Credential
Факт выдачи: ссылка на achievement, получатель (recipient), issuedOn, evidence, verification.
Verification
2.0 — hosted (JSON по URL) или signed (JWS). 3.0 — proof по модели VC Data Model.

Пример assertion (Open Badges 2.0)

Минимальный hosted-бейдж в формате JSON-LD.

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Assertion",
  "id": "https://issuer.example/assertions/42",
  "recipient": {
    "type": "email",
    "hashed": true,
    "identity": "sha256$a1b2c3..."
  },
  "badge": "https://issuer.example/badges/python-basics",
  "issuedOn": "2026-03-14T10:00:00Z",
  "verification": { "type": "HostedBadge" },
  "evidence": "https://issuer.example/evidence/42"
}
Контекст w3id.org/openbadges/v2; recipient захеширован, проверка — HostedBadge.

Как устроена проверка

  • Hosted (2.0) — клиент запрашивает assertion по URL и сверяет данные с профилем эмитента.
  • Signed (2.0) — бейдж представлен как JWS; подпись проверяется публичным ключом эмитента.
  • Verifiable Credentials (3.0) — проверка криптографического proof без обращения к эмитенту.
  • Revocation — отозванные бейджи помечаются через revocationList или статус-механизм VC.

Точки интеграции

  • LMS / EdTech — выдача бейджа по завершении курса через вебхук или API платформы.
  • HRM / ATS — импорт подтверждённых навыков кандидата и сотрудников.
  • Бэкпаки и кошельки — экспорт/импорт по стандарту для переносимости.

Частые вопросы

С какой версии стандарта начать?
Если нужна максимальная совместимость с существующими сервисами — 2.0. Если важна криптографическая проверяемость и независимость от эмитента — закладывайте 3.0 на базе Verifiable Credentials. На практике многие платформы поддерживают обе.
Как скрывается e-mail получателя?
Идентификатор получателя обычно хешируется (например, sha256 с солью), а в assertion указывается hashed: true. Это позволяет подтвердить владельца, не раскрывая адрес в открытом виде.
Где взять официальную спецификацию?
Спецификации публикует 1EdTech: Open Badges 2.0 и Open Badges 3.0. Версия 3.0 опирается на W3C Verifiable Credentials Data Model. Ссылки собраны в разделе документации.

Документация и живая проверка