JSON-LD обяснено
JSON-LD е обикновен JSON с един допълнителен ред, който казва какво означават полетата. Този ред превръща локалното име на поле в глобално дефинирано, така че система, която никога не е виждала вашите данни, пак да може да разбере за какво говорите. Той е стандарт на W3C от 2014 г., по него търсачките четат тази страница и върху него е изграден моделът на данните на W3C за проверимите удостоверения.
Проблемът с обикновения JSON
JSON казва как се записват данните. Той не казва нищо за това какво означава което и да е от тях. Поле с име name може да бъде човек, фирма или продукт. Поле с име id може да бъде номер на клиент, номер на паспорт или ред в нечия база данни. Две системи могат и двете да генерират напълно валиден JSON и въпреки това да не са съгласни за нито едно от полетата в него.
На практика тази пропаст се затваря със споразумение. Двете страни записват какво означават полетата и изграждат софтуера си според това. Това работи за една интеграция, става скъпо при десет и спира да работи изцяло, когато удостоверение, издадено в една държава, трябва да бъде разбрано от верификатор в друга, с когото никой не е разговарял предварително.
Какво прави @context
JSON-LD затваря тази пропаст в самия документ. Един @context съпоставя всяко късо име на поле с глобално уникален идентификатор, обикновено URL адрес, контролиран от този, който е дефинирал речника. Полето остава кратко и четимо за човека и става недвусмислено за машината.
Обикновен JSON
{
"name": "Alex Jansen",
"birthDate": "1994-03-21",
"jobTitle": "Compliance Officer"
}Валиден, четим и безсмислен за всеки, на когото не е казано предварително какво трябва да съдържат полетата.
Същите данни като JSON-LD
{
"@context": "https://schema.org",
"@type": "Person",
"name": "Alex Jansen",
"birthDate": "1994-03-21",
"jobTitle": "Compliance Officer"
}Всяко поле вече сочи към публикувана дефиниция, така че система, която никога не е виждала този документ, пак може да го прочете правилно.
- @context назовава речника, в който е дефинирано всяко поле в документа.
- @type казва какъв вид обект описва документът, така че от този речник да се изберат правилните дефиниции.
Нищо в самите данни не се променя. Същите стойности в същата форма вече носят указател към дефиницията на всяко поле. Приемаща система, която разпознава речника, знае точно какво й е предадено, а такава, която не го разпознава, пак може да прочете документа като обикновен JSON и да пренебрегне останалото.
Това е цялата идея. Значението пътува заедно с документа, вместо да живее в спецификация, за която двете страни е трябвало да се договорят предварително.
Къде се появява в проверимите удостоверения
Моделът на данните за проверимите удостоверения 2.0 (Verifiable Credentials Data Model 2.0) на W3C, препоръка на W3C от 15 май 2025 г., е изграден върху JSON-LD. Всяко удостоверение започва с @context, чиято първа стойност е споделеният речник на удостоверенията, така че термините, общи за всяко удостоверение, а именно издателят, субектът, датите на валидност и информацията за статуса, означават едно и също навсякъде.
Всичко отвъд това идва от втори речник. Университет публикува такъв за полетата на дипломите, търговска камара публикува такъв за полетата на фирмената регистрация. Верификатор, който се интересува от дипломи, зарежда първия, верификатор, който се интересува от данни за дружества, зарежда втория, и никой от тях не трябва да се променя, когато другият добави поле.
Именно това позволява на един формат на удостоверение да носи данни, които никой не е предвидил, когато форматът е бил написан, а това е свойството, от което се нуждае отворената екосистема и от което затвореният профил няма нужда.
Подписване на свързани данни
Удостоверението трябва и да бъде подписано, а моделът на данните умишлено оставя избор в това отношение. Обгръщащото доказателство (enveloping proof) обвива цялото удостоверение в контейнер за подпис, като JWT. Байтовете се подписват точно такива, каквито са, така че всичко, което ги пренарежда или преформатира по пътя, нарушава подписа.
Вграденото доказателство Data Integrity работи по обратния начин. Документът първо се привежда в канонична форма, дефинирана от RDF Dataset Canonicalization и препоръка на W3C от 21 май 2024 г., а подписът обхваща тази форма, а не байтовете. Тъй като каноничната форма не зависи от реда на ключовете, от празните знаци или от това кои къси имена използва @context, подписът оцелява при записването на документа отново на друго място.
Къде се вписва в EUDI Wallet
Не там, където повечето хора предполагат. Архитектурата и референтната рамка посочва два формата на удостоверения за европейския портфейл, SD-JWT VC и mdoc, и нито един от тях не е JSON-LD. Организация, която издава в EUDI Wallet днес, няма да срещне @context по пътя.
Причината е приложимостта. И двата формата имат фиксирана структура, един механизъм за подпис и нито един документ, който верификаторът трябва да отиде и да изтегли, преди да може да провери каквото и да било. За портфейл, работещ на телефон, и верификатор, който трябва да отговаря за милисекунди, това е по-ценно от отворения речник.
JSON-LD заслужава мястото си там, където данните трябва да пътуват отвъд екосистемата, която ги е дефинирала: паспорти на продукти и данни от веригата на доставки, междусекторни пилотни проекти и типове удостоверения, които никой централен профил никога няма да изброи. Двата свята се припокриват по-често, отколкото се конкурират, а организациите, работещи и в двата, обикновено накрая поддържат и двата.
Другият JSON-LD, който вече сте използвали
Много преди удостоверенията JSON-LD се превърна в начина, по който уебсайтът казва на търсачката за какво е една страница. Блок от него в изходния код на страницата, използващ речника schema.org, е това, което превръща страницата в разпознавана статия, продукт, събитие или организация. Тази страница съдържа такъв.
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "JSON-LD обяснено",
"description": "Какво добавя JSON-LD към обикновения JSON, как @context придава на всяко поле едно значение и къде проверимите удостоверения го използват.",
"image": "https://www.credenco.com/images/og-default.jpg",
"datePublished": "2026-10-15",
"dateModified": "2026-10-15",
"inLanguage": "bg",
"mainEntityOfPage": "https://www.credenco.com/bg/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"
}
}
}Това е същият формат с различен речник и е най-ясният начин да се види смисълът. Тук никой не е договарял нищо с никоя търсачка. @context сочи към schema.org, търсачката вече познава този речник и страницата се разбира от страна, с която никога не е разговаряла. Удостоверение, пресичащо граница, прави точно същото.
Какво ви струва
Контекстът трябва да е наличен. Верификатор, който го изтегля по време на верификацията, е добавил мрежова зависимост към решение, свързано със сигурността, а този, който обслужва този документ, може да промени това, което удостоверението изглежда, че казва. Реалните внедрявания фиксират контекстите, които приемат, и ги доставят със софтуера, вместо да ги разрешават на живо.
Канонизирането също е реална работа. Превръщането на документ в каноничен набор от данни преди подписване е значително повече код от подписването на байтове, а начините му на отказ са фини. Документите са и по-големи, което започва да има значение при QR код или NFC докосване.
Нищо от това не прави JSON-LD грешен избор. То го прави избор: плащате за отворени речници там, където данните трябва да надживеят споразумението, което ги е създало, и ги пропускате там, където фиксиран профил вече казва всичко, от което двете страни се нуждаят.
Какво означава това за Вас
Издател
Издаването в EUDI Wallet означава SD-JWT VC или mdoc и JSON-LD изобщо не възниква. Издаването в екосистема на W3C превръща вашия @context в дългосрочен ангажимент: той е публичната дефиниция на вашите полета, а промяната му разваля работата на всеки верификатор, който е кеширал старата.
Верификатор
Решете кои контексти приемате и ги доставяйте със своя софтуер. Изтеглянето на контекст по време на верификация прави отдалечен сървър част от вашето решение за сигурност и вмъква мрежова заявка в средата на времето ви за отговор.
Разработчик
Четете документ JSON-LD като обикновен JSON, когато всичко, от което се нуждаете, е едно поле, и прибягвайте до пълен процесор само там, където наистина разширявате или канонизирате. Голяма част от сложността, която хората приписват на JSON-LD, се намира в пътя на подписването, а не в пътя на разбора.
Свързани термини
Често задавани въпроси
JSON-LD все още ли е просто JSON?
Да. Всеки документ JSON-LD е валиден JSON и софтуер, който трябва само да прочете поле, може да го третира като такъв. Допълнителният механизъм влиза в действие, когато разширите документа до пълната му форма или го канонизирате за подписване, което повечето програмен код, четящ удостоверение, никога не прави.
Използва ли EUDI Wallet JSON-LD?
Не. Архитектурата и референтната рамка (ARF) посочва SD-JWT VC и mdoc като формати на удостоверенията и нито един от тях не използва JSON-LD. Той е от значение за екосистемите на проверимите удостоверения на W3C, за паспортите на продукти и данните от веригата на доставки, а не за самия европейски портфейл.
Изтегля ли верификаторът @context всеки път?
Не би трябвало. Извличането на контекст по време на верификация вмъква мрежова заявка в решение, свързано със сигурността, и дава на отдалечен сървър възможност да променя това, което документът изглежда, че казва. Реализациите фиксират контекстите, които приемат, и ги доставят със софтуера, което премахва и забавянето.
Това същият JSON-LD ли е, който четат търсачките?
Същият формат с различен речник. Структурираните данни на уеб страница насочват своя @context към schema.org, докато удостоверението го насочва към речника на удостоверенията и към всичко друго, от което се нуждае. Правилата за обработка са идентични и в двата случая.
Източници
Тази страница е с информационна цел и не представлява правен съвет. За авторитетни указания направете справка директно със спецификациите на W3C.