Skip to content

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

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

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

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

Јавна страница акредитива ​

Сваки акредитив има јавни URL:

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

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

Јавна страница акредитива

Страница акредитива увек приказује дугме Add to LinkedIn profile како би прималац могао да сачува акредитив директно у своје LinkedIn Licenses & Certifications. (Ако је издавалац поставио ИД организације на LinkedIn-у, LinkedIn унапред попуњава верификовану страницу компаније; у супротном користи име издаваоца.) Јединствени падајући мени Download нуди две опције: Badge image (изворни PNG) и Certificate (A4 PDF за штампу, генерисан у ходу на /certify-badge/award/{guid}/pdf).

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

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

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

Јавна страница за дељење са дугмадима друштвених мрежа и кодом за уградњу

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

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

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

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

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

Страница за верификацију QR кодом са идентитетом значке и QR кодом за скенирање

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

PDF сертификат ​

Сваки акредитив може се преузети као A4 PDF сертификат спреман за штампу. Опција Certificate налази се у падајућем менију Download на јавној страници акредитива (/awards/{guid}) — не на страници за верификацију, која садржи само QR код за скенирање и сирови Open Badge JSON. Њеним избором PDF се генерише у ходу (на /certify-badge/award/{guid}/pdf) са сликом значке, именом примаоца, издаваоцем, критеријумима, датумом издавања, необавезним датумом истека и QR кодом који води назад на живи URL за верификацију.

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

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

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

Како се подељена веза до значке приказује као картица прегледа на друштвеној мрежи

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

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

Акредитиве можете слати е-поштом на два начина:

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

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

Модални прозор за слање е-поште на страници — примаоци уносе адресе, наслов и личну напомену

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

Стварна е-пошта коју добија сваки адресат

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

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

  1. Пронађите акредитив на страници Credentials.
  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}JSON BadgeClass
/certify-badge/award/{guid}JSON тврдње (акредитив)

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

Пример — верификација акредитива:

bash
curl https://api.badges.ninja/certify-badge/award/abc123-def456
json
{
  "@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-ови слика значака ​

Слике значака чувају се на Amazon S3 и сервирају преко нашег глобалног CDN-а под садржајно адресираним, непроменљивим URL-ом изведеним из криптографског хеша (SHA-256) бајтова слике. То значи:

  • Слике су трајне и садржајно адресиране — URL је изведен из самих бајтова, па се не могу фалсификовати нити неприметно заменити
  • URL-ови слика у Open Badge JSON-у изгледају као https://badges.ninja/images/{sha256}.png
  • Слике се сервирају са ивице CDN-а, па се брзо учитавају било где у свету и остају доступне током читавог трајања акредитива

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

badges.ninja Documentation