Baking за Open Badge: како JSON живи унутар PNG-а
„Испечена“ (baked) Open Badge је PNG са уграђеним JSON-ом уверења као метаподацима слике. Фајл значке ЈЕ само уверење. Како baking функционише и како верификовати испечену значку.
Nacho founded Badges Ninja to make issuing verifiable digital credentials as simple as a single API call — Open Badge v2.0 badges and certificates, minted, hosted, and verifiable without standing up your own issuer infrastructure.
Преузмите Open Badge од скоро било ког издавалаца и добићете PNG обичног изгледа. Пошаљите га у чету, приложите уз имејл, одштампајте га. Изгледа као свака друга слика. Али фајл носи други, невидљиви слој: само уверење, записано у слику као метаподатке. То заједница око Open Badges назива испеченом значком (baked badge) и зато значка може да путује као један једини фајл, а да ипак доказује ко ју је издао, коме и за шта.
Овај водич објашњава шта је baking, где се у фајлу налазе подаци, како их верификатор чита и шта ви као издавалац уверења треба да одлучите. Не морате да пишете код да бисте користили испечене значке. Ако издајете преко https://badges.ninja, baking се дешава аутоматски. Али разумевање механике помаже вам да одговорите на питања која примаоци и послодавци заиста постављају: „Да ли је ова слика права?“ и „Може ли је неко просто копирати?“
Шта значи „baking“
Open Badge има два дела које је лако помешати:
- Слика. PNG или SVG који људи виде на профилу, слајду или сертификату.
- Тврдња (assertion). Мали JSON документ који износи чињенице: ко је прималац (као хеширани идентификатор), која класа значке је стечена, ко ју је издао, када и где се може верификовати.
Baking је чин уписивања assertion-а у слику тако да се ова два дела не могу раздвојити. Резултат је један фајл. Пружите некоме PNG и дали сте му и слику и тврдњу која стоји иза ње.
Идеја потиче из спецификације Open Badges, коју је првобитно развио Mozilla, а данас је одржава 1EdTech. Поента дизајна је преносивост. У почетку су значке живеле унутар једне платформе, а премештање на ново место значило је поновно слање и наду да ће метаподаци преживети. Испечен фајл носи сопствене метаподатке куда год да оде.
Где JSON живи унутар PNG-а
PNG фајл је кратак потпис иза кога следи низ chunk-ова. Сваки chunk има дужину, четворословни тип, неке податке и контролни збир. Прегледачи цртају пикселе из IDAT chunk-ова и игноришу типове chunk-ова које не разумеју. Управо та толеранција омогућава baking: можете додати chunk пун текста и сваки преглед слика на свету ће и даље нормално приказати слику.
За Open Badges 2.0, assertion иде у текстуални chunk са кључном речи openbadges. Типови текстуалних chunk-ова који га могу садржати су:
| Chunk | Кодирање | Напомене |
|---|---|---|
tEXt | Latin-1 | Једноставно, али ограничено на Latin-1 знакове. |
iTXt | UTF-8 | Пожељније, јер имена и описи често нису ASCII. |
Који год chunk да се користи, распоред је исти: кључна реч openbadges, раздвојник, па садржај (payload). Payload је једно од двоје, зависно од тога како је издавалац одлучио да испече:
- Сам assertion JSON. Фајл је самоописан. Верификатор може да прочита тврдњу без иједног мрежног позива.
- URL који води до хостованог assertion-а. Фајл је мањи, а издавалац може да задржи живи запис као меродаван, на пример да покаже да је значка касније повучена или је истекла.
Постоји и трећа варијанта за потписане значке, где је payload потписани токен уместо обичног JSON-а. Ако су потписи важни за ваш случај употребе, прочитајте како верификовати потпис Open Badge-а.
А SVG?
SVG значке се такође могу пећи, јер је SVG XML. Assertion се смешта унутар фајла у елемент XML простора имена openbadges, а атрибут verify носи URL хостованог assertion-а. Принцип је исти као код PNG-а: метаподаци путују унутар фајла слике. У пракси већина платформи пече PNG, јер се PNG прихвата скоро свуда где људи желе да отпреме значку.
Како изгледа уграђени assertion
За формат 2.0, хостовани assertion је JSON-LD који повезује примаоца, класу значке и метод верификације. Скраћен пример:
{
"@context": "https://w3id.org/openbadges/v2",
"type": "Assertion",
"id": "https://example.org/assertions/abc123",
"recipient": {
"type": "email",
"hashed": true,
"salt": "deadsea",
"identity": "sha256$c7ef86405ba71b85acd8e2e95166c4b111448089f2e1599f42fe1bba46e865c5"
},
"badge": "https://example.org/badges/data-analysis-101",
"issuedOn": "2026-05-14T00:00:00Z",
"verification": { "type": "hosted" }
}
Обратите пажњу на примаоца. Имејл се не чува у чистом облику; то је SHA-256 хеш са salt-ом. То је битно за фајл који је намењен да се прослеђује. Свако ко има PNG може да прочита assertion, па он не сме да открије адресу примаоца. Верификатор који већ зна имејл може да га хешира истим salt-ом и провери да ли се поклапа. За обилазак овог документа поље по поље, погледајте Open Badge JSON-LD водич.
Како верификатор чита испечену значку
Верификација испечене значке је кратак, механички поступак:
- Отворите PNG и прођите кроз његове chunk-ове.
- Пронађите текстуални chunk са кључном речи
openbadges. - Прочитајте payload. Ако је JSON, парсирајте га. Ако је URL, преузмите га.
- Проверите да ли се assertion односи на класу значке и издавалаца које очекујете и да ли идентитет примаоца одговара особи која је предочава.
- Ако је тип верификације
hosted, потврдите да хостовани assertion и даље постоји на свомidURL-у и да није повучен нити истекао.
Корак 5 је онај који људи прескачу, а управо он чини уверење поузданим. Уграђена копија је снимак стања. Хостовани запис је извор истине.
Самостално читање у Node-у
Сваки PNG можете прегледати кратком скриптом. Ова пролази кроз chunk-ове и исписује openbadges payload, обрађујући и tEXt и iTXt:
import { readFileSync } from "node:fs";
import { inflateSync } from "node:zlib";
const png = readFileSync(process.argv[2]);
let pos = 8; // skip the 8-byte PNG signature
while (pos < png.length) {
const length = png.readUInt32BE(pos);
const type = png.toString("ascii", pos + 4, pos + 8);
const data = png.subarray(pos + 8, pos + 8 + length);
if (type === "iTXt" || type === "tEXt") {
const nul = data.indexOf(0);
const keyword = data.toString("latin1", 0, nul);
if (keyword === "openbadges") {
let text;
if (type === "tEXt") text = data.toString("latin1", nul + 1);
else {
const compressed = data[nul + 1] === 1;
let p = nul + 3; // skip compression flag + method
p = data.indexOf(0, p) + 1; // language tag
p = data.indexOf(0, p) + 1; // translated keyword
const body = data.subarray(p);
text = (compressed ? inflateSync(body) : body).toString("utf8");
}
console.log(text);
process.exit(0);
}
}
pos += 12 + length; // length + type + data + CRC
}
console.error("No openbadges chunk found: this PNG is not baked.");
process.exit(1);
Покрените га са node extract-badge.mjs my-badge.png. Ако је фајл испечен, видећете JSON или URL. Ако није, добијате обичну поруку „not baked“. Ово је алат за учење, а не потпун валидатор: не проверава контролне збирове chunk-ова, не парсира потписане payload-е и не преузима хостовани запис.
Ако не желите да пишете код, онлајн валидатор значака или прегледач PNG метаподатака приказаће исти chunk. Формат је стандард, па сваки усаглашени алат чита сваку усаглашену значку.
Зашто је baking важан
Преносивост. Уверење које је само PNG може се послати имејлом, отпремити на платформу за учење или сачувати у личној архиви. За ношење није потребан налог.
Пут до верификације који надживљава маркетиншки сајт издаваоца. Уграђени assertion именује издаваоца и упућује на хостовани запис, па верификатор може да почне само од фајла.
Офлајн и нискотехнолошки токови рада. Када је payload пун JSON, читалац може да провери тврдњу на машини без мреже, а хостовани запис да верификује касније.
Доказ који је тешко површно фалсификовати. Свако може да направи скриншот значке. Скриншот нема метаподатке, па се не може верификовати као фајл значке. Већ то одваја право уверење од копиране слике. То не спречава некога да испече лажни assertion у украдену слику, зато и постоји корак хостоване верификације.
Ограничења baking-а
Будите искрени према примаоцима у вези са овим, јер то утиче на начин на који описујете своја уверења.
- Метаподаци се бришу. Многе друштвене мреже, оптимизатори слика и апликације за поруке поново кодирају отпремљени садржај и одбацују chunk-ове који нису пиксели. Испечена значка објављена на друштвеној мрежи обично више није испечена. То је очекивано и зато је јавни линк за верификацију важан уз фајл.
- Baking сам по себи није доказ. Уграђени JSON може да напише било ко. Поверење потиче од хостованог assertion-а на домену издаваоца или од важећег потписа.
- Измене слике кидају везу. Промена величине или поновно чување у едитору може да изгуби chunk.
- Само PNG и SVG. JPEG нема еквивалентну конвенцију chunk-ова у спецификацији, па се значка у стилу фотографије извезена као JPEG не може испећи на стандардан начин.
Практичан закључак: фајл са испеченом значком третирајте као згодног носиоца, а страницу за верификацију као ауторитет. Ако процењујете формате за свој програм, Open Badges наспрам PDF сертификата објашњава зашто машински читљиво уверење надмашује статичан документ.
Како baking функционише на https://badges.ninja
Када доделите значку на https://badges.ninja, платформа гради Open Badge assertion за тог примаоца и пече га у слику значке као део издавања. Не подешавате алат нити покрећете команду. Ток:
- Дизајнирате значку у визуелном дизајнеру или отпремате сопствену слику.
- Издајете награду са контролне табле, из CSV отпремања за масовне награде или преко API-ја.
- Платформа креира assertion, пече га у PNG и чува резултат уз награду.
- Прималац добија јавну страницу за верификацију на
https://badges.ninja/awards/<awardId>, PDF сертификат, QR код и опцију Add to LinkedIn.
Ако дизајн значке користи поља за спајање (merge fields), као што је име примаоца, свака награда добија персонализовану слику, а управо та персонализована слика се пече.
Baking се третира као унапређење издавања, а не као препрека: ако се нека слика не може испећи (на пример дегенерисана слика-замена), награда се и даље издаје са оригиналном сликом, а јавна страница за верификацију и Open Badge JSON-LD остају нетакнути. Слика коју отпремате такође мора да задовољи минималну величину, па се ситан празан canvas одбија пре него што стигне до „пекаре“.
Пошто је јавна страница ауторитет, свако може да провери награду без регистрације. Машински читљив Open Badge v2.0 JSON-LD за награду доступан је на https://api.badges.ninja/certify-badge/award/<awardId>.
Издавање једне награде преко API-ја
Већина читалаца користиће контролну таблу, али ако аутоматизујете издавање, један захтев креира награду (а испечена слика долази уз њу). Замените кључ и id значке својима:
const res = await fetch("https://api.badges.ninja/awards", {
method: "POST",
headers: { "X-Api-Key": "bws_YOUR_KEY_HERE", "Content-Type": "application/json" },
body: JSON.stringify({
badgeId: "your-badge-id",
recipient: { name: "Jane Smith", email: "jane@example.com" },
issuedOn: Date.now(),
}),
});
const { awardId } = await res.json();
const verifyUrl = `https://badges.ninja/awards/${awardId}`;
Позив враћа HTTP 200 са { "awardId": "<guid>" }. Изградите URL за верификацију из тог id-а. За подешавање кључа и потпуну референцу захтева погледајте документацију Awards API-ја и водич за аутентификацију.

Практични савети за издаваоце
Увек објавите линк за верификацију уз фајл. Ставите линк у имејл о награди, на сертификат и на сваку страницу на којој се значка приказује. Пошто друштвене платформе бришу метаподатке, линк је оно што чува верификабилност уверења након дељења.
Користите чисту слику пристојне величине. Почните од PNG-а са стварним димензијама. Значка коју је направио дизајнер у нормалној резолуцији пече се поуздано; замена од 1 пиксела не.
Не мењајте достављени фајл. Реците примаоцима да деле оригинално преузимање или линк за верификацију, а не исечен скриншот.
Одлучите шта желите да кажете о повлачењу и истеку. Пошто је хостовани запис меродаван, испечен фајл може да надживи статус уверења. Јасно то наведите у документацији програма да би послодавци знали да проверавају страницу за верификацију уместо да верују само фајлу.
Тестирајте једну значку од почетка до краја. Издајте награду себи, преузмите PNG, пропустите га кроз скрипту изнад или јавни валидатор и отворите линк за верификацију. Пет минута тестирања показује шта ће ваши примаоци доживети.

Често постављана питања
Да ли је испечена значка исто што и дигитални сертификат? Не. Сертификат је обично PDF за читање и штампање. Испечена значка је слика која уједно носи машински читљиве податке о уверењу. https://badges.ninja производи обоје из исте награде.
Могу ли да испечем значку без платформе? Да. Спецификација је отворена и постоје библиотеке за неколико језика. Тежи део је хостовање assertion-а на стабилном URL-у, што верификацију чини смисленом. Тај део платформа преузима уместо вас.
Да ли baking открива имејл примаоца? Не, када је идентитет хеширан. Assertion чува хеш са salt-ом, па фајл не открива адресу.
Хоће ли LinkedIn прочитати испечене податке? LinkedIn-ов ток Add to Profile ради на основу назива уверења, издаваоца, датума и URL-а, а не из метаподатака фајла. Погледајте додавање Add to LinkedIn дугмета.
Резиме
Испечена Open Badge је PNG (или SVG) са уверењем уписаним у текстуални chunk под називом openbadges. Она чини значку преносивом и самоописном, али право поверење потиче од хостованог assertion-а на домену издаваоца. Пеците ради преносивости, објавите линк за верификацију ради поверења и очекујте да ће друштвене мреже обрисати метаподатке.
Спремни да издате своје прво верификабилно уверење? Почните бесплатно на badges.ninja — визуелни дизајнер, јавна страница за верификацију, PDF сертификат, излаз Open Badge v2.0. Без кредитне картице.
Како је овај чланак настао
Неки текстови на овом блогу настају уз помоћ ВИ асистента, а затим их проверава, чињенично потврђује и уређује тим Badges Ninja пре објављивања. Сваки код и цена се проверавају у односу на актуелни производ. Више о нашем уредничком и ВИ процесу прочитајте на нашој страници о уредничком процесу .

О аутору
Nacho Coll
Founder & Engineer at Badges Ninja
Nacho founded Badges Ninja to make issuing verifiable digital credentials as simple as a single API call — Open Badge v2.0 badges and certificates, minted, hosted, and verifiable without standing up your own issuer infrastructure. Writes about the Open Badges spec, credential verification, and running a credentialing platform serverless on AWS, from the operator side of the wire.
Више од Nacho Coll
- Open Badges за кодинг бутцампове: верификована уверења у размери целе генерације19. нов 2026. · 10мин читања
- Подешавање вебхукова за догађаје са значкама: интеграција у реалном времену са вашим бекендом16. нов 2026. · 8мин читања
- Истек рока и обнављање Open Badge-а: управљање животним веком временски ограничених акредитива12. нов 2026. · 10мин читања


