Дељење и верификација

Свака додела на badges.ninja има јавну страницу за верификацију којој свако може приступити без пријављивања. Примаоци могу делити своје значке на друштвеним мрежама, путем е-поште или копирањем директног линка.

И примаоци имају сопствени портал

Ако сте кроз badges.ninja освојили значку, можете се пријавити (без лозинке) на badges.ninja/me да бисте видели све своје значке на једном месту и уредили јавни профил на badges.ninja/u/<ваш-надимак>. Погледајте Портал за примаоце.

Јавна страница доделе

Свака додела има јавни URL:

https://badges.ninja/awards/{guid}

Ова страница приказује слику значке (учитану са IPFS-а), назив и опис значке, име примаоца, назив и логотип издаваоца, датум издавања и евентуални датум истека, као и критеријуме које је прималац испунио да би заслужио значку. Свако ко има линк може отворити страницу и потврдити да је уверење аутентично.

Ако је издавалац подесио ID LinkedIn организације, појављује се дугме Додај у LinkedIn профил како би прималац уверење сачувао директно у своје LinkedIn лиценце и сертификате. Дугме Преузми значку служи изворну слику значке (директно са IPFS-а), а Преузми PDF у ходу генерише штампив A4 сертификат.

Јавна страница за дељење

Страница за дељење нуди опције за дељење на друштвеним мрежама:

https://badges.ninja/awards/{guid}/share

Са ове странице примаоци могу делити своју значку на:

• LinkedIn — објављује на њиховом LinkedIn феду или дугметом Додај у LinkedIn профил додаје уверење директно у профил (када је издавалац подесио ID LinkedIn организације)
• Twitter / X — објављује твит са линком до значке и прилагођеним текстом за дељење
• Facebook — дели на њиховој Facebook временској линији
• WhatsApp — шаље поруку са линком до значке
• Telegram — шаље поруку са линком до значке
• Send Email — отвара модал на самој страници који испоручује стилизовану е-пошту једном или више прималаца (погледајте Дељење путем е-поште испод)
• Copy Link — копира URL за верификацију у клипборд
• Embed snippets — копира спремне <img> и <iframe> HTML исечке за уграђивање значке у веб-сајт, интранет или потпис е-поште

Верификација QR кодом

Посебна страница за верификацију исцртава скенирајући QR код који показује на сопствени URL — савршено за штампане сертификате, банере догађаја или снимке екрана за LinkedIn.

https://badges.ninja/verify/{guid}

Свако ко QR скенира камером телефона стиже на живу страницу за верификацију, где може потврдити да се значка налази на badges.ninja, да прати спецификацију Open Badge v2.0 и (на Pro плану) да је усидрена на ланцу преко Matchain. Идентитет примаоца приказује се као SHA-256 хеш, па е-поште никада нису јавно изложене.

PDF сертификат

Свака додела има дугме Download Certificate на јавној страници за верификацију. Кликом на њега у ходу се генерише A4 PDF спреман за штампу који укључује слику значке, име примаоца, издаваоца, критеријуме, датум издавања, опциони датум истека и QR код који води назад на живи URL за верификацију.

Прегледи на друштвеним мрежама

Када се линк до значке подели на LinkedIn-у, X-у, Slack-у, Facebook-у, WhatsApp-у или путем е-поште, платформа дохвата крајњу тачку за дељење и исцртава богату картицу из Open Graph метаподатака које badges.ninja емитује:

• Слика значке као слика прегледа
• Назив значке као наслов
• Име издаваоца и име примаоца у опису

Тиме значке изгледају професионално где год да се деле — примаоци не морају да прилажу сопствену слику нити да пишу текст. Преглед се генерише на серверу на /certify-badge/award/{guid}/share-html и кешира на ивици CDN-а, па се прегледи појављују тренутно чак и при првом дељењу.

Дељење путем е-поште

Доделе значки можете слати путем е-поште на два начина:

Са јавне странице за дељење

Примаоци могу делити своју значку са пријатељима, менторима или потенцијалним послодавцима кликом на Send Email на страници за дељење. Отвара се модал у којем уносе једну или више адреса е-поште, опциону тему и личну поруку:

Сваки прималац добија стилизовану HTML е-пошту са личном поруком примаоца и дугметом на један клик за приказ јавне странице доделе:

Са контролне табле

Издаваоци могу било коју доделу послати путем е-поште са странице Awards на контролној табли:

1. Пронађите доделу на страници Awards.
2. Кликните дугме Send у реду или отворите модал са детаљима и кликните Resend email.
3. Унесите е-пошту примаоца и пошаљите.

Иста шаблонска е-пошта користи се за оба тока.

JSON крајње тачке Open Badge v2.0

Ради интероперабилности са другим платформама за значке, badges.ninja нуди стандардни Open Badge v2.0 JSON на овим јавним крајњим тачкама:

Крајња тачка	Опис
/certify-badge/issuer/{guid}	JSON профила издаваоца
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (додела)

Ове крајње тачке враћају JSON-LD усклађен са спецификацијом Open Badge v2.0. Друге платформе за значке и верификатори могу користити ове податке за валидацију уверења.

Пример — верификујте доделу:

curl https://api.badges.ninja/certify-badge/award/abc123-def456

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Assertion",
  "id": "https://api.badges.ninja/certify-badge/award/abc123-def456",
  "recipient": {
    "type": "email",
    "identity": "sha256$..."
  },
  "badge": "https://api.badges.ninja/certify-badge/badge/xyz789",
  "issuedOn": "2025-01-15T00:00:00.000Z",
  "verification": {
    "type": "hosted"
  }
}

URL-ови слика на IPFS-у

Слике значки прикачене су на IPFS (InterPlanetary File System) преко нашег сопственог гејтвеја ipfs.ninja. То значи:

• Слике су трајне и адресиране садржајем — не могу се мењати нити тихо заменити
• URL-ови слика у Open Badge JSON-у изгледају као https://ipfs.ninja/ipfs/{cid}
• Исти ID садржаја разрешава се преко било ког јавног IPFS гејтвеја (cloudflare-ipfs.com, ipfs.io итд.) — ваше значке нису везане за једног добављача

Пошто је слика део Open Badge тврдње, накнадна замена графике значке не нарушава претходно издате доделе: стари IPFS CID остаје разрешив заувек, па историјске доделе задржавају своју изворну слику чак и ако дизајн значке промените за нова издавања.