JSON-LD spjegat
JSON-LD huwa JSON ordinarju b'linja żejda waħda li tgħid xi jfissru l-oqsma. Dik il-linja ddawwar isem ta' qasam lokali f'wieħed definit globalment, biex sistema li qatt ma rat id-data tiegħek xorta tkun tista' taħdem x'inti tgħid. Ilu standard tal-W3C mill-2014, hekk jaqraw il-magni tat-tiftix proprju din il-paġna, u fuqu hu mibni l-mudell tad-data tal-W3C għall-kredenzjali verifikabbli.
Il-problema bil-JSON sempliċi
JSON jgħid kif tinkiteb id-data. Ma jgħid xejn dwar xi tfisser. Qasam jismu name jista' jkun persuna, kumpanija jew prodott. Qasam jismu id jista' jkun numru ta' klijent, numru ta' passaport jew ringiela fid-database ta' xi ħadd. Żewġ sistemi jistgħu t-tnejn joħorġu JSON perfettament validu u xorta ma jaqblux dwar kull qasam fih.
Fil-prattika dik il-lakuna tingħalaq bi ftehim. Iż-żewġ naħat jiktbu xi jfissru l-oqsma u jibnu s-software tagħhom skont dan. Dan jaħdem għal integrazzjoni waħda, jogħla fil-prezz b'għaxra, u jieqaf jaħdem għalkollox meta kredenzjal maħruġ f'pajjiż wieħed irid jinftiehem minn verifikatur f'ieħor li ħadd ma kellem minn qabel.
X'jagħmel il-@context
JSON-LD jagħlaq dik il-lakuna ġewwa d-dokument innifsu. @context jimmappja kull isem qasir ta' qasam ma' identifikatur uniku globalment, normalment URL ikkontrollat minn min iddefinixxa l-vokabularju. Il-qasam jibqa' qasir u jinqara mill-bniedem u jsir mingħajr ambigwità għall-magna.
JSON sempliċi
{
"name": "Alex Jansen",
"birthDate": "1994-03-21",
"jobTitle": "Compliance Officer"
}Validu, jinqara u bla tifsira għal kull min ma ngħatax minn qabel x'suppost ikun hemm fl-oqsma.
L-istess data bħala JSON-LD
{
"@context": "https://schema.org",
"@type": "Person",
"name": "Alex Jansen",
"birthDate": "1994-03-21",
"jobTitle": "Compliance Officer"
}Kull qasam issa jipponta lejn definizzjoni ppubblikata, u għalhekk sistema li qatt ma rat dan id-dokument xorta tista' taqrah sewwa.
- @context isemmi l-vokabularju li fih huwa definit kull qasam tad-dokument.
- @type jgħid x'tip ta' ħaġa jiddeskrivi d-dokument, biex minn dak il-vokabularju jintgħażlu d-definizzjonijiet it-tajba.
Xejn mid-data nnifisha ma jinbidel. L-istess valuri fl-istess forma issa jġorru pointer lejn id-definizzjoni ta' kull qasam. Sistema li tirċievi u tagħraf il-vokabularju taf eżatt x'ingħatat, u waħda li ma tagħrafx xorta tista' taqra d-dokument bħala JSON ordinarju u tinjora l-bqija.
Din hija l-idea kollha. It-tifsira tivvjaġġa mad-dokument minflok ma toqgħod fi speċifikazzjoni li ż-żewġ naħat kellhom jaqblu dwarha minn qabel.
Fejn jitfaċċa fil-kredenzjali verifikabbli
Il-W3C Verifiable Credentials Data Model 2.0, W3C Recommendation mill-15 ta' Mejju 2025, huwa mibni fuq JSON-LD. Kull kredenzjal jiftaħ b'@context li l-ewwel valur tiegħu huwa l-vokabularju komuni tal-kredenzjali, biex it-termini li kull kredenzjal għandu komuni, l-emittent, is-suġġett, id-dati tal-validità u l-informazzjoni dwar l-istat, ifissru l-istess kullimkien.
Kull ma hemm lil hinn minn dan jiġi minn tieni vokabularju. Università tippubblika wieħed għall-oqsma tad-diplomi, kamra tal-kummerċ wieħed għall-oqsma tar-reġistrazzjoni tal-kumpaniji. Verifikatur li jimpurtah mid-diplomi jtella' l-ewwel wieħed, wieħed li jimpurtah mid-data tal-kumpaniji jtella' t-tieni, u l-ebda wieħed minnhom ma jrid jinbidel meta l-ieħor iżid qasam.
Dan hu li jippermetti lil format wieħed ta' kredenzjal iġorr data li ħadd ma antiċipa meta nkiteb il-format, u dik hija l-proprjetà li teħtieġ ekosistema miftuħa u li ma teħtieġx profil magħluq.
L-iffirmar ta' data marbuta
Kredenzjal irid jiġi wkoll iffirmat, u l-mudell tad-data jħalli hemm għażla apposta. Prova li tgeżwer tagħlaq il-kredenzjal kollu f'kontenitur ta' firma bħal JWT. Il-bytes jiġu ffirmati eżatt kif inhuma, u għalhekk kull ma jerġa' jordnahom jew jifformattjahom fit-triq ikisser il-firma.
Prova Data Integrity inkorporata taħdem bil-maqlub. Id-dokument l-ewwel jitqiegħed f'forma kanonika, definita minn RDF Dataset Canonicalization u W3C Recommendation mill-21 ta' Mejju 2024, u l-firma tkopri dik il-forma minflok il-bytes. Billi l-forma kanonika ma tiddependix mill-ordni taċ-ċwievet, mill-ispazji jew minn liema ismijiet qosra jiġri li juża l-@context, il-firma tibqa' valida anke jekk id-dokument jinkiteb mill-ġdid x'imkien ieħor.
Fejn jidħol fl-EUDI Wallet
Mhux fejn jassumu l-biċċa l-kbira tan-nies. L-Architecture and Reference Framework isemmi żewġ formati ta' kredenzjal għall-kartiera Ewropea, SD-JWT VC u mdoc, u l-ebda wieħed minnhom mhu JSON-LD. Organizzazzjoni li toħroġ illum lejn l-EUDI Wallet mhux se tiltaqa' ma' ebda @context fit-triq.
Ir-raġuni hija l-fattibbiltà tal-implimentazzjoni. Iż-żewġ formati għandhom struttura fissa, mekkaniżmu wieħed ta' firma u ebda dokument li verifikatur irid imur iġib qabel ma jkun jista' jiċċekkja xi ħaġa. Għal kartiera li taħdem fuq telefown u verifikatur li jrid iwieġeb f'millisekondi, dan jiswa aktar minn vokabularju miftuħ.
JSON-LD jaqla' postu fejn id-data trid tivvjaġġa lil hinn mill-ekosistema li ddefinietha: passaporti tal-prodotti u data tal-katina tal-provvista, proġetti pilota bejn setturi, u tipi ta' kredenzjal li ebda profil ċentrali mhu se jelenka qatt. Iż-żewġ dinjiet jirkbu fuq xulxin aktar milli jikkompetu, u l-organizzazzjonijiet li jaħdmu fit-tnejn normalment jispiċċaw jappoġġjaw it-tnejn.
Il-JSON-LD l-ieħor, dak li diġà użajt
Ħafna qabel il-kredenzjali, JSON-LD sar il-mod kif sit web jgħid lil magna tat-tiftix fuq xiex taqbel paġna. Blokk tiegħu fis-sors tal-paġna, bil-vokabularju ta' schema.org, huwa dak li jdawwar paġna f'artiklu, prodott, avveniment jew organizzazzjoni rikonoxxuti. Din il-paġna ġġorr wieħed.
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "JSON-LD spjegat",
"description": "X'iżid JSON-LD mal-JSON sempliċi, kif @context jagħti lil kull qasam tifsira waħda, u fejn jużawh il-kredenzjali verifikabbli.",
"image": "https://www.credenco.com/images/og-default.jpg",
"datePublished": "2026-10-15",
"dateModified": "2026-10-15",
"inLanguage": "mt",
"mainEntityOfPage": "https://www.credenco.com/mt/explained/json-ld",
"author": {
"@type": "Organization",
"name": "Credenco",
"url": "https://www.credenco.com/"
},
"publisher": {
"@type": "Organization",
"name": "Credenco",
"logo": {
"@type": "ImageObject",
"url": "https://www.credenco.com/logo.svg"
}
}
}Huwa l-istess format b'vokabularju differenti, u huwa l-aktar mod ċar biex tara l-punt. Ħadd hawn ma qabel fuq xejn ma' ebda magna tat-tiftix. Il-@context jipponta lejn schema.org, il-magna tat-tiftix diġà taf dak il-vokabularju, u l-paġna tinftiehem minn parti li qatt ma kellmet. Kredenzjal li jaqsam fruntiera jagħmel eżatt l-istess.
X'jiswielek
Il-kuntest irid ikun disponibbli. Verifikatur li jiġbdu fil-mument tal-verifika żied dipendenza fuq in-netwerk ma' deċiżjoni ta' sigurtà, u min iservi dak id-dokument jista' jbiddel dak li l-kredenzjal jidher li qed jgħid. L-installazzjonijiet reali jissikkaw il-kuntesti li jaċċettaw u jwassluhom mas-software minflok ma jsolvuhom fil-ħin reali.
Il-kanonizzazzjoni hija wkoll xogħol veru. Li ddawwar dokument f'sett ta' data kanoniku qabel l-iffirmar huwa konsiderevolment aktar kodiċi milli tiffirma bytes, u l-modi kif tista' tfalli huma sottili. Id-dokumenti huma wkoll akbar, u dan jibda jgħodd fuq kodiċi QR jew f'mess NFC.
Xejn minn dan ma jagħmel JSON-LD l-għażla ħażina. Jagħmlu għażla: ħallas għal vokabularji miftuħa fejn id-data trid tgħix aktar mill-ftehim li ħalaqha, u aqbeż fuqhom fejn profil fiss diġà jgħid dak kollu li jeħtieġu ż-żewġ naħat.
Xi jfisser dan għalik
Emittent
Li toħroġ lejn l-EUDI Wallet ifisser SD-JWT VC jew mdoc, u JSON-LD qatt ma jidħol. Li toħroġ lejn ekosistema W3C tagħmel mill-@context tiegħek impenn fit-tul: hija d-definizzjoni pubblika tal-oqsma tiegħek, u l-bdil tagħha jkisser kull verifikatur li żamm il-qadima fil-cache.
Verifikatur
Iddeċiedi liema kuntesti taċċetta u wassalhom mas-software tiegħek. Li tiġbed wieħed waqt il-verifika jagħmel server remot parti mid-deċiżjoni ta' sigurtà tiegħek u jqiegħed sejħa tan-netwerk f'nofs il-ħin ta' rispons tiegħek.
Żviluppatur
Aqra dokument JSON-LD bħala JSON ordinarju meta kull ma jeħtieġlek huwa qasam wieħed, u mur għal proċessur sħiħ biss fejn tassew tespandi jew tikkanonizza. Il-biċċa l-kbira tal-kumplessità li n-nies jattribwixxu lil JSON-LD tinsab fit-triq tal-iffirmar, mhux f'dik tal-qari.
Termini relatati
Mistoqsijiet frekwenti
JSON-LD għadu sempliċement JSON?
Iva. Kull dokument JSON-LD huwa JSON validu, u software li jrid biss jaqra qasam wieħed jista' jittrattah hekk. Il-makkinarju żejjed jidħol biss meta tespandi dokument fil-forma sħiħa tiegħu jew tikkanonizzah għall-iffirmar, ħaġa li l-biċċa l-kbira tal-kodiċi li jaqra kredenzjal qatt ma tagħmel.
L-EUDI Wallet juża JSON-LD?
Le. L-Architecture and Reference Framework isemmi SD-JWT VC u mdoc bħala l-formati tal-kredenzjali, u l-ebda wieħed minnhom ma juża JSON-LD. Jiswa għall-ekosistemi W3C b'kredenzjali verifikabbli, għall-passaporti tal-prodotti u għad-data tal-katina tal-provvista, mhux għall-kartiera Ewropea nnifisha.
Verifikatur iniżżel il-@context kull darba?
M'għandux. Li tiġbed kuntest waqt il-verifika tqiegħed sejħa tan-netwerk f'nofs deċiżjoni ta' sigurtà u tagħti lil server remot il-possibbiltà li jbiddel dak li d-dokument jidher li qed jgħid. L-implimentazzjonijiet jissikkaw il-kuntesti li jaċċettaw u jwassluhom mas-software, u dan ineħħi wkoll id-dewmien.
Dan huwa l-istess JSON-LD li jaqraw il-magni tat-tiftix?
L-istess format b'vokabularju differenti. Id-data strutturata fuq paġna web tipponta l-@context tagħha lejn schema.org, filwaqt li kredenzjal jippontah lejn il-vokabularju tal-kredenzjali u lejn dak l-ieħor li jeħtieġ. Ir-regoli tal-ipproċessar huma identiċi fiż-żewġ każijiet.
Sorsi
Din il-paġna hija informattiva u ma tikkostitwixxix parir legali. Għal gwida awtorevoli kkonsulta direttament l-ispeċifikazzjonijiet tal-W3C.