Open Badge'i küpsetamine lahti seletatud: kuidas JSON PNG-s elab
„Küpsetatud“ Open Badge on PNG, mille pildi metaandmetesse on põimitud kinnituse JSON. Märgi fail ON volikiri. Kuidas küpsetamine töötab ja kuidas küpsetatud märki kontrollida.
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.
Lae alla Open Badge peaaegu iga väljaandja käest ja saad tavalise välimusega PNG. Pane see vestlusesse, lisa e-kirjale, prindi välja. See näeb välja nagu iga teine pilt. Kuid failil on teine, nähtamatu kiht: volikiri ise, kirjutatud pilti metaandmetena. Open Badgesi kogukond nimetab seda küpsetatud märgiks (baked badge) ja just seetõttu saab märk liikuda ühe failina ning siiski tõestada, kes selle välja andis, kellele ja mille eest.
See juhend selgitab, mis on küpsetamine, kus failis andmed asuvad, kuidas kontrollija need tagasi loeb ja mida pead volikirjade väljaandjana otsustama. Küpsetatud märkide kasutamiseks ei pea sa koodi kirjutama. Kui annad välja https://badges.ninja kaudu, toimub küpsetamine sinu eest. Aga mehhanismi mõistmine aitab vastata küsimustele, mida saajad ja tööandjad tegelikult esitavad: „Kas see pilt on ehtne?“ ja „Kas keegi saab seda lihtsalt kopeerida?“
Mida „küpsetamine“ tähendab
Open Badge’il on kaks osa, mida on lihtne segi ajada:
- Pilt. PNG või SVG, mida inimesed näevad profiilil, slaidil või tunnistusel.
- Kinnitus (assertion). Väike JSON-dokument, mis esitab faktid: kes on saaja (räsitud identifikaatorina), millise märgiklassi sai, kes selle välja andis, millal ja kus seda kontrollida.
Küpsetamine tähendab kinnituse kirjutamist pilti nii, et neid ei saa lahutada. Tulemuseks on üks fail. Kui annad kellelegi PNG, oled andnud talle nii pildi kui ka selle taga oleva väite.
Idee pärineb Open Badgesi spetsifikatsioonist, mille töötas algselt välja Mozilla ja mida nüüd haldab 1EdTech. Disaini mõte on teisaldatavus. Algusaegadel elasid märgid ühe platvormi sees ning uude kohta kolimine tähendas uuesti üleslaadimist ja lootust, et metaandmed säilivad. Küpsetatud fail kannab oma metaandmeid endaga kaasas, kuhu iganes see läheb.
Kus JSON PNG-s asub
PNG-fail on lühike allkiri, millele järgneb tükkide (chunks) jada. Igal tükil on pikkus, neljatäheline tüüp, andmed ja kontrollsumma. Vaatajad joonistavad pikslid IDAT-tükkidest ja ignoreerivad tükitüüpe, mida nad ei mõista. Just see sallivus teeb küpsetamise võimalikuks: võid lisada teksti täis tüki ja iga pildivaataja maailmas kuvab pildi ikkagi tavapäraselt.
Open Badges 2.0 puhul läheb kinnitus tekstitükki võtmesõnaga openbadges. Tekstitüübid, mis seda hoida saavad, on:
| Tükk | Kodeering | Märkused |
|---|---|---|
tEXt | Latin-1 | Lihtne, kuid piiratud Latin-1 märkidega. |
iTXt | UTF-8 | Eelistatud, sest nimed ja kirjeldused ei ole sageli ASCII. |
Olenemata sellest, millist tükki kasutatakse, on paigutus sama: võtmesõna openbadges, eraldaja, seejärel andmeosa. Andmeosa on üks kahest, sõltuvalt sellest, kuidas väljaandja küpsetada otsustas:
- Kinnituse JSON ise. Fail on ise kirjeldav. Kontrollija saab väite lugeda ilma ühegi võrgupäringuta.
- URL, mis viitab majutatud kinnitusele. Fail on väiksem ja väljaandja saab säilitada elava kirje autoriteetsena, näiteks et näidata märgi hilisemat tühistamist või aegumist.
Allkirjastatud märkide jaoks on olemas kolmas variant, kus andmeosa on tavalise JSON-i asemel allkirjastatud token. Kui allkirjad on sinu kasutusjuhtumi jaoks olulised, loe kuidas Open Badge’i allkirja kontrollida.
Aga SVG?
SVG-märke saab samuti küpsetada, sest SVG on XML. Kinnitus paigutatakse faili openbadges XML-nimeruumi elementi ja atribuut verify kannab majutatud kinnituse URL-i. Põhimõte on sama mis PNG-l: metaandmed liiguvad pildifaili sees. Praktikas küpsetab enamik platvorme PNG-d, sest PNG-d aktsepteeritakse peaaegu kõikjal, kuhu inimesed märki üles laadida tahavad.
Milline näeb välja põimitud kinnitus
Vormingus 2.0 on majutatud kinnitus JSON-LD, mis seob saaja, märgiklassi ja kontrollimeetodi. Lühendatud näide:
{
"@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" }
}
Pane tähele saajat. E-posti ei hoita selgel kujul; see on soolatud SHA-256 räsi. See on oluline faili puhul, mis on mõeldud ringlema. Igaüks, kellel on PNG, saab kinnituse lugeda, seega ei tohi kinnitus saaja aadressi lekitada. Kontrollija, kes e-posti juba teab, saab selle sama soolaga räsida ja kontrollida, kas see ühtib. Selle dokumendi väljade kaupa läbivaatamiseks vaata Open Badge JSON-LD ülevaadet.
Kuidas kontrollija küpsetatud märki loeb
Küpsetatud märgi kontrollimine on lühike, mehaaniline protsess:
- Ava PNG ja käi läbi selle tükid.
- Leia tekstitükk võtmesõnaga
openbadges. - Loe andmeosa. Kui see on JSON, parsi see. Kui see on URL, too see kätte.
- Kontrolli, et kinnitus viitab märgiklassile ja väljaandjale, keda ootad, ning et saaja identiteet vastab selle esitajale.
- Kui kontrollitüüp on
hosted, veendu, et majutatud kinnitus on endiselt olemas omaidURL-il ning pole tühistatud ega aegunud.
Viiendat sammu jätavad inimesed vahele, kuigi just see teeb volikirja usaldusväärseks. Põimitud koopia on hetktõmmis. Majutatud kirje on tõe allikas.
Lugemine ise Node’is
Mis tahes PNG-d saab uurida lühikese skriptiga. See käib tükid läbi ja prindib openbadges andmeosa, käsitledes nii tEXt kui ka 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);
Käivita see käsuga node extract-badge.mjs my-badge.png. Kui fail on küpsetatud, näed JSON-i või URL-i. Kui mitte, saad lihtsa teate „not baked“. See on õppevahend, mitte täielik valideerija: see ei kontrolli tükkide kontrollsummasid, ei parsi allkirjastatud andmeosi ega too majutatud kirjet kätte.
Kui sa pigem koodi ei kirjuta, näitab sama tükki veebipõhine märgivalideerija või PNG metaandmete vaatur. Vorming on standard, seega loeb iga nõuetele vastav tööriist iga nõuetele vastavat märki.
Miks küpsetamine loeb
Teisaldatavus. Volikirja, mis on lihtsalt PNG, saab e-kirjaga saata, õppeplatvormile üles laadida või isiklikku arhiivi salvestada. Selle kandmiseks pole kontot vaja.
Kontrollitee, mis elab üle väljaandja turundusveebi. Põimitud kinnitus nimetab väljaandja ja viitab majutatud kirjele, seega saab kontrollija alustada ainult failist.
Võrguühenduseta ja lihtsa tehnikaga töövood. Kui andmeosa on täielik JSON, saab lugeja väidet kontrollida masinas ilma võrguta ning majutatud kirjet hiljem kontrollida.
Tõend, mida on juhuslikult raske võltsida. Märgist saab ekraanipildi teha igaüks. Ekraanipildil pole metaandmeid, seega ei saa seda märgifailina kontrollida. Juba see eristab päris volikirja kopeeritud pildist. See ei takista kedagi võltsitud kinnitust varastatud pildi sisse küpsetamast, mistõttu majutatud kontrolli samm eksisteerib.
Küpsetamise piirangud
Ole saajatega nende osas aus, sest need mõjutavad seda, kuidas oma volikirju kirjeldad.
- Metaandmed eemaldatakse. Paljud sotsiaalvõrgustikud, pildioptimeerijad ja sõnumirakendused kodeerivad üleslaadimised ümber ning viskavad mitte-pikslilised tükid minema. Sotsiaalvoogu postitatud küpsetatud märk pole tavaliselt enam küpsetatud. See on ootuspärane ja just seetõttu on faili kõrval oluline avalik kontrollilink.
- Küpsetamine pole iseenesest tõend. Põimitud JSON-i võib kirjutada igaüks. Usaldus tuleb väljaandja domeenil asuvast majutatud kinnitusest või kehtivast allkirjast.
- Pildi muutmine katkestab seose. Suuruse muutmine või redaktoris uuesti salvestamine võib tüki kaotada.
- Ainult PNG ja SVG. JPEG-l pole spetsifikatsioonis samaväärset tükikonventsiooni, seega ei saa JPEG-ina eksporditud fotostiilis märki standardsel viisil küpsetada.
Praktiline järeldus: kohtle küpsetatud faili mugava kandjana ja kontrollilehte autoriteedina. Kui kaalud oma programmi jaoks vorminguid, selgitab Open Badges vs PDF-tunnistused, miks masinloetav volikiri lööb staatilise dokumendi.
Kuidas küpsetamine https://badges.ninja-s töötab
Kui annad märgi välja https://badges.ninja-s, koostab platvorm selle saaja jaoks Open Badge’i kinnituse ja küpsetab selle väljaandmise käigus märgi pilti. Sa ei seadista ühtegi tööriista ega käivita ühtegi käsku. Voog:
- Kujundad märgi visuaalses kujundajas või laed üles oma pildi.
- Annad välja auhinna: töölaualt, CSV-üleslaadimisega hulgiauhindade jaoks või API kaudu.
- Platvorm loob kinnituse, küpsetab selle PNG-sse ja salvestab tulemuse auhinna juurde.
- Saaja saab avaliku kontrolli lehe aadressil
https://badges.ninja/awards/<awardId>, PDF-tunnistuse, QR-koodi ja valiku Add to LinkedIn.
Kui märgi kujundus kasutab liitmisvälju, näiteks saaja nime, saab iga auhind personaliseeritud pildi ja just see personaliseeritud pilt küpsetatakse.
Küpsetamist käsitletakse väljaandmise täiendusena, mitte väravana: kui konkreetset pilti ei saa küpsetada (näiteks degenereerunud kohatäitepilt), antakse auhind siiski välja originaalpildiga ning avalik kontrolli leht ja Open Badge JSON-LD jäävad mõjutamata. Üleslaetud pilt peab ka ületama minimaalse suuruse, seega lükatakse pisike tühi lõuend tagasi enne, kui see küpsetajani jõuab.
Kuna avalik leht on autoriteet, saab igaüks auhinda kontrollida ilma registreerumata. Auhinna masinloetav Open Badge v2.0 JSON-LD on saadaval aadressil https://api.badges.ninja/certify-badge/award/<awardId>.
Ühe auhinna väljaandmine API kaudu
Enamik lugejaid kasutab töölauda, aga kui automatiseerid väljaandmist, loob üks päring auhinna (ja küpsetatud pilt tuleb kaasa). Asenda võti ja märgi id oma omadega:
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}`;
Päring tagastab HTTP 200 koos { "awardId": "<guid>" }. Koosta kontrolli URL sellest id-st. Võtme seadistamise ja täieliku päringute viite leiad Awards API dokumentatsioonist ja autentimisjuhendist.

Praktilisi nõuandeid väljaandjatele
Avalda faili kõrval alati kontrollilink. Pane link auhinna e-kirja, tunnistusele ja igale lehele, kus märki kuvatakse. Kuna sotsiaalplatvormid metaandmed eemaldavad, hoiab just link volikirja jagamise järel kontrollitavana.
Kasuta puhast, piisavalt suurt lähtepilti. Alusta PNG-st päris mõõtmetega. Disaineri tehtud tavaresolutsiooniga märk küpseb usaldusväärselt; 1-pikslilise kohatäitega see ei õnnestu.
Ära muuda tarnitud faili. Ütle saajatele, et nad jagaksid originaalallalaadimist või kontrollilinki, mitte kärbitud ekraanipilti.
Otsusta, mida tühistamise ja aegumise kohta öelda. Kuna majutatud kirje on autoriteetne, võib küpsetatud fail volikirja staatusest kauem elada. Ütle seda oma programmi dokumentatsioonis selgelt, et tööandjad teaksid kontrollilehte vaadata, mitte usaldada ainult faili.
Testi üht märki algusest lõpuni. Anna auhind endale, laadi PNG alla, lase see läbi ülaltoodud skripti või avaliku valideerija ja ava kontrollilink. Viis minutit testimist näitab, mida su saajad kogevad.

Korduma kippuvad küsimused
Kas küpsetatud märk on sama mis digitaalne tunnistus? Ei. Tunnistus on tavaliselt PDF lugemiseks ja printimiseks. Küpsetatud märk on pilt, mis kannab ka masinloetavaid volikirja andmeid. https://badges.ninja loob mõlemad samast auhinnast.
Kas ma saan märki ilma platvormita küpsetada? Jah. Spetsifikatsioon on avatud ja teeke on mitmele keelele. Raskem osa on kinnituse majutamine stabiilsel URL-il, mis annab kontrollimisele tähenduse. Selle osa teeb platvorm sinu eest ära.
Kas küpsetamine paljastab saaja e-posti? Mitte siis, kui identiteet on räsitud. Kinnitus salvestab soolatud räsi, seega fail aadressi ei avalda.
Kas LinkedIn loeb küpsetatud andmeid? LinkedIni Add to Profile voog töötab volikirja nime, väljaandja, kuupäeva ja URL-i põhjal, mitte faili metaandmetest. Vaata Add to LinkedIn nupu lisamist.
Kokkuvõte
Küpsetatud Open Badge on PNG (või SVG), mille volikiri on kirjutatud tekstitükki nimega openbadges. See teeb märgi teisaldatavaks ja ise kirjeldavaks, kuid tõeline usaldus tuleb väljaandja domeenil asuvast majutatud kinnitusest. Küpseta teisaldatavuse nimel, avalda kontrollilink usalduse nimel ja oota, et sotsiaalvõrgustikud metaandmed eemaldavad.
Valmis andma välja oma esimest kontrollitavat volikirja? Alusta tasuta badges.ninja-s — visuaalne kujundaja, avalik kontrolli leht, PDF-tunnistus, Open Badge v2.0 väljund. Krediitkaarti pole vaja.
Kuidas see artikkel valmis
Osa selle blogi postitustest on koostatud tehisintellekti abiga ning seejärel üle vaadatud, faktikontrollitud ja toimetatud Badges Ninja meeskonna poolt enne avaldamist. Iga koodinäide ja hind on kontrollitud reaalse toote vastu. Loe lähemalt meie toimetus- ja AI-protsessi kohta meie toimetusprotsessi lehel .

Autorist
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.
Rohkem autorilt Nacho Coll
- Programmeerimiskooli Open Badges: kontrollitavate tunnistuste väljaandmine terve kohordi mastaabis19. nov 2026 · 9min lugemist
- Veebikonksude seadistamine märgisündmuste jaoks: reaalajas integratsioon sinu taustasüsteemiga16. nov 2026 · 7min lugemist
- Open Badge'i aegumine ja uuendamine: ajaliselt piiratud kvalifikatsioonide elutsükli haldus12. nov 2026 · 9min lugemist


