Kako izdati Open Badges iz datoteke CSV v manj kot 5 minutah

Če ste kdaj izdajali poverilnice skupini po enega prejemnika naenkrat, že poznate težavo: to se ne skalira prek približno desetih ljudi, preden se spremeni v celo popoldne kopiranja in lepljenja imen in e-poštnih naslovov. Skupina bootcampa s 40 ljudmi, seznam 500 udeležencev konference ali uvajanje korporativnega usposabljanja za 5.000 ljudi — vsi potrebujejo isto: naložite seznam, izberite značko, kliknite Izdaj in odidite.

Točno to počne Bulk Credentials na https://badges.ninja. Ta vodnik pokriva celoten potek: pripravo datoteke CSV, konfiguracijo paketa, spremljanje njegovega poteka in reševanje neurejenih primerov iz resničnega sveta — vrstica prejemnika s tipkarsko napako, paket, ki se prekine na pol poti, ali program, ki želi izdajati na enak način iz svojih lastnih sistemov namesto z nadzorne plošče.

Preden začnete: kaj potrebujete

Dve stvari, ki ju verjetno že imate:

1. Značka — oblikovana enkrat v vizualnem oblikovalniku in ponovno uporabljena za vsakega prejemnika v paketu. Če je še niste ustvarili, si oglejte naš vodnik za oblikovanje vašega prvega preverljivega potrdila.
2. CSV s prejemniki — ime, e-poštni naslov in (izbirno) datum izdaje. To je celotna shema.

Ne potrebujete izdajateljskega računa za vsakega prejemnika, poštnega strežnika ali kakršne koli kode. Vse v tem razdelku se dogaja na nadzorni plošči.

Korak 1: Pripravite datoteko CSV

Format seznama prejemnikov je namerno minimalen:

name,email,issued_on
Maria Gonzalez,maria@example.com,2026-07-01
David Kim,david@example.com,2026-07-01
Priya Patel,priya@example.com,

• name — obvezno. Zapolni polje prejemnika na trditvi (assertion) in na potrdilu.
• email — obvezno. To postane identiteta prejemnika na trditvi Open Badge v2.0 — zgoščeno s posebno soljo za vsako poverilnico pred shranjevanjem, nikoli se ne hrani v čistem besedilu.
• issued_on — izbirno. Pustite prazno in paket uporabi trenutek, ko se vsaka vrstica obdela; nastavite ga izrecno, če za nazaj vnašate skupino, ki je dejansko končala prejšnji mesec.

Večina lastnikov programov to izvozi neposredno od tam, kjer že spremljajo dokončanja — Airtable, Google Sheets, preglednica, ki jo je predal inštruktor, ali CSV, izvlečen iz redovalnice v LMS. Poseben izvozni pripomoček ni potreben; deluje kateri koli CSV s temi tremi stolpci.

Pogoste pasti CSV (in kako jih predogled ujame)

Nekaj težav se v resničnih seznamih prejemnikov pojavlja nenehno, običajno zato, ker je bil CSV sestavljen z združevanjem dveh ali treh izvornih listov:

• Presledki na koncu e-poštnih naslovov — kopiranje iz seznama PDF ali izvoza iz Googlovega obrazca pogosto nosi neviden presledek. V celici preglednice izgleda v redu, a pri nalaganju ne prestane preverjanja e-pošte.
• Podvojene vrstice — isti prejemnik se pojavi dvakrat, ker sta bila seznam skupine in seznam poznih prijav združena brez odstranjevanja dvojnikov.
• Nedosledni formati datumov — en stolpec z 2026-07-01, pomešan s 07/01/2026 iz drugega izvoza. Držite se ISO 8601 (YYYY-MM-DD) in to popolnoma izgine.
• Neujemanja v velikih in malih črkah glav — Email proti email proti E-mail. Razčlenjevalnik je prizanesljiv do pogostih različic, a povsem prilagojeno ime glave se ne bo samodejno preslikalo.

Nobena od teh ni usodna — korak predogleda (spodaj) vsako od njih izpostavi, preden se kar koli izda, zato je popravek »uredite preglednico, znova naložite« namesto »ugotovite, kateri od 3.000 prejemnikov je dobil pokvarjeno značko«.

Korak 2: Konfigurirajte paket

Na nadzorni plošči odprite Credentials → Bulk Credentials in izberite značko, ki jo izdajate. To je korak, kjer nastavite vse, kar velja za celoten paket: samo značko, skupni datum izdaje, če v CSV ne vnašate datumov po vrsticah, in (če ga vaš izdajateljski profil ima) organizacijski LinkedIn ID, ki bo vsakemu prejemniku omogočil, da poverilnico doda v svoj profil z enim klikom.

To je dober trenutek, da še enkrat preverite, ali je značka, ki ste jo izbrali, končna različica — prejemniki bodo videli sliko in merila, ki so ji priložena v trenutku izdaje, ne tega, kar posodobite pozneje.

Korak 3: Naložite in predoglejte

Spustite svoj CSV in platforma ga razčleni, vam pokaže tabelo predogleda in označi vse, česar ne more obdelati — manjkajoč e-poštni naslov, napačno oblikovan datum, podvojeno vrstico. Nič se ne izda, dokler ne potrdite predogleda.

Ta korak predogleda je pomembnejši, kot se zdi. Tipkarsko napako v eni vrstici CSV z 2.000 vrsticami je z očmi zlahka spregledati in veliko ceneje jo je ujeti, preden je 1.999 pravilnih vrstic že izdanih, kot jo poskušati razvozlati pozneje. Popravite označene vrstice v svoji preglednici, znova naložite in predogled se posodobi.

Korak 4: Zaženite paket

Kliknite Izdaj in paket se začne obdelovati. Vrstica napredka spremlja dokončane proti preostalim vrsticam, paket pa teče na strežniški strani — zavihka vam ni treba imeti odprtega, zaprtje prenosnika sredi paketa pa ne izgubi vašega mesta.

Ta zadnji del je vredno jasno pojasniti, ker je to podrobnost, ki pri velikih skupinah dejansko šteje: stanje paketa živi na strežniku, ne v vašem brskalniku. Če vam povezava pade, prenosnik zaspi ali preprosto zaprete zavihek, ker se začenja sestanek, paket še naprej teče (ali se nadaljuje točno tam, kjer je ostal, če ste ga zaustavili) namesto da bi se začel znova od ničle. Za skupino bootcampa s 40 ljudmi je to prijeten dodatek. Za korporativno uvajanje s 5.000 vrsticami je to razlika med »enostavno deluje« in »nekdo mora dvajset minut paziti na zavihek brskalnika«.

Delujoč paket lahko tudi namerno zaustavite — recimo, nekdo opozori, da besedilo meril značke potrebuje popravek sredi zagona s 3.000 vrsticami — težavo odpravite in nadaljujte brez ponovnega izdajanja že dokončanih vrstic.

Korak 5: Obravnavanje napak

Resnični seznami prejemnikov imajo slabe vrstice: e-poštni naslov s tipkarsko napako v domeni, polje imena, ki je dejansko prazno, podvojen vnos zaradi združevanja dveh izvoženih listov. Ko vrstica ne uspe, se paket ne ustavi — nadaljuje z obdelavo preostanka in označi napako za poznejši pregled. Dobite izvoz rezultatov, ki natančno pokaže, katere vrstice so uspele in katere ne, tako da lahko popravite le neuspele vrstice in znova zaženete majhen naknadni paket namesto ponovnega preverjanja celotnega seznama.

To je pomembno za navado izvoza CSV, ki je že običajna na nadzorni plošči poverilnic — kadar koli lahko izvlečete CSV tega, kar je bilo dejansko izdano, ga primerjate s svojim izvornim seznamom in natančno veste, kdo še potrebuje značko.

Pot prek API-ja: enak potek, brez nadzorne plošče

Vse zgoraj predpostavlja, da nekdo sedi za nadzorno ploščo in klika skozi čarovnika. Če vaša dokončanja že živijo v sistemu — LMS, CRM, avtomatizaciji preglednic — lahko enak potek množičnih poverilnic vodite neposredno iz Awards API.

Minimalen klic za izdajo posameznemu prejemniku izgleda takole:

curl -X POST https://api.badges.ninja/awards \
  -H "X-Api-Key: bws_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d" \
  -H "Content-Type: application/json" \
  -d '{
    "badgeId": "badge_9f8e7d6c5b4a",
    "recipient": {
      "name": "Maria Gonzalez",
      "email": "maria@example.com"
    },
    "issuedOn": "2026-07-01T00:00:00Z"
  }'

Ali v Pythonu, ko se sprehodite čez vrstice, prebrane iz istega CSV, ki bi ga sicer naložili ročno:

import csv
import requests

API_KEY = "bws_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d"
BADGE_ID = "badge_9f8e7d6c5b4a"

with open("recipients.csv") as f:
    for row in csv.DictReader(f):
        requests.post(
            "https://api.badges.ninja/awards",
            headers={"X-Api-Key": API_KEY},
            json={
                "badgeId": BADGE_ID,
                "recipient": {"name": row["name"], "email": row["email"]},
                "issuedOn": row.get("issued_on") or None,
            },
        )

To je vredno poseči, ko izdajo poverilnic sproži nekaj povsem drugega — webhook ob dokončanju tečaja, sprememba faze v CRM, oddaja obrazca — namesto da oseba ročno izvozi CSV. Avtentikacijo in celotno obliko zahteve/odgovora pokrivamo v hitrem vodniku po API-ju. Vsaka poverilnica, ustvarjena na ta način, je enaka tisti, ustvarjeni prek čarovnika na nadzorni plošči: enaka trditev Open Badge v2.0, enak URL za preverjanje, enako potrdilo PDF.

Čarovnik na nadzorni plošči proti API-ju: kaj dejansko želite?

Večina ekip začne s čarovnikom na nadzorni plošči, ker ne zahteva ničesar razen CSV, na API pa preidejo šele, ko je bil isti paket ročno zagnan trikrat ali štirikrat in se vzorec očitno splača avtomatizirati.

Zasebnost: kaj se dejansko shrani

CSV z imeni in e-poštnimi naslovi so osebni podatki in vredno je vedeti, kaj se z njimi zgodi po nalaganju. E-poštni naslov prejemnika se nikoli ne shrani v čistem besedilu na sami poverilnici — zgoščen je s posebno soljo za vsako poverilnico kot del trditve Open Badge v2.0, po formatu identitete prejemnika hashed iz specifikacije. Ta zgostitev je tisto, kar preverjevalec preveri, ne surovi naslov. Polje imena se shrani tako, kot je bilo vneseno, saj je namenjeno temu, da je vidno na potrdilu in strani za preverjanje. Če je treba vrstico po izdaji popraviti — najpogosteje napačno zapisano ime — lahko posamezno poverilnico uredite ali prekličete z nadzorne plošče poverilnic, ne da bi se dotaknili preostanka paketa.

Po paketu: obvestite prejemnike

Izdaja značke in obveščanje prejemnika o njej sta dva različna koraka. Če vaš CSV še ne sproži e-pošte prek vašega lastnega sistema, vam potek množičnega deljenja na nadzorni plošči omogoča, da večkratno izberete poverilnice, ki ste jih pravkar ustvarili, in vsem naenkrat pošljete prilagojeno e-pošto za deljenje — oglejte si množično pošiljanje e-pošte za deljenje za celoten vodnik, vključno s tem, kako se prilagoditev za vsakega prejemnika (ime, slika značke, povezava za preverjanje) samodejno zamenja.

Kdaj je Bulk Credentials pravo orodje

Množično izdajanje je prava izbira vedno, kadar okvir »paketa« ustreza resničnemu svetu: skupina, ki je končala isti dan, konferenca, ki se je pravkar končala, uvajanje usposabljanja, ki dosega rok skladnosti. Če namesto tega izdajate enkratne poverilnice ob doseganju posameznih mejnikov — ena napredovanje, en dokončan projekt — je obrazec za posamezno poverilnico hitrejši od sestavljanja CSV z eno vrstico.

Za karkoli ponavljajočega — isti tečaj, ki poteka vsak mesec, tekoči onboarding cevovod — se pot prek API-ja zgoraj splača nastaviti enkrat. Spremeni »ročno zaženi množične poverilnice pri vsaki skupini« v »dokončanja že samodejno izdajajo poverilnice«, kar je različica tega poteka, ki jo večina lastnikov programov dejansko želi po drugem ali tretjem ročnem paketu.

Pripravljeni izdati svojo prvo preverljivo poverilnico? Začnite brezplačno na badges.ninja — vizualni oblikovalnik, javna stran za preverjanje, potrdilo PDF, izhod Open Badge v2.0. Kreditna kartica ni potrebna.