Kako izdati Open Badges iz CSV datoteke za manje od 5 minuta

Ako ste ikad izdavali vjerodajnice skupini jednog po jednog primatelja, već znate u čemu je problem: to se ne može skalirati preko otprilike deset ljudi prije nego što se pretvori u cijelo popodne kopiranja i lijepljenja imena i e-adresa. Skupina bootcampa od 40 osoba, popis sudionika konferencije od 500 ljudi ili uvođenje korporativne obuke za 5.000 ljudi — svima treba isto: prenesite popis, odaberite značku, kliknite Izdaj i otiđite.

Upravo to radi Bulk Credentials na https://badges.ninja. Ovaj vodič pokriva cijeli tijek rada: pripremu CSV datoteke, konfiguriranje serije, praćenje njezina izvođenja te rješavanje neurednih stvarnih slučajeva — reda s primateljem u kojem je tipfeler, serije koja se prekine na pola puta ili programa koji želi izdavati na isti način iz vlastitih sustava umjesto s nadzorne ploče.

Prije nego što počnete: što vam treba

Dvije stvari, a obje vjerojatno već imate:

1. Značka — dizajnirana jednom u vizualnom dizajneru i ponovno iskorištena za svakog primatelja u seriji. Ako je još niste izradili, pogledajte naš vodič za dizajniranje vaše prve provjerljive potvrde.
2. CSV s primateljima — ime, e-adresa i (opcionalno) datum izdavanja. To je cijela shema.

Ne trebate izdavateljski račun po primatelju, poslužitelj za e-poštu niti bilo kakav kôd. Sve u ovom odjeljku odvija se na nadzornoj ploči.

Korak 1: Pripremite CSV datoteku

Format popisa primatelja namjerno je minimalan:

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 — obavezno. Popunjava polje primatelja na tvrdnji (assertion) i na potvrdi.
• email — obavezno. Ovo postaje identitet primatelja na Open Badge v2.0 tvrdnji — heširano s posebnom soli po vjerodajnici prije pohrane, nikad se ne čuva u čistom tekstu.
• issued_on — opcionalno. Ostavite prazno i serija koristi trenutak u kojem se svaki red obrađuje; postavite ga izričito ako naknadno unosite skupinu koja je zapravo završila prošli mjesec.

Većina vlasnika programa ovo izvozi izravno odande gdje već prate završetke — Airtable, Google Sheets, tablicu koju je predao instruktor ili CSV izvučen iz ocjena u LMS-u. Nije potreban nikakav poseban alat za izvoz; radi bilo koji CSV s ta tri stupca.

Uobičajene zamke s CSV-om (i kako ih pretpregled uhvati)

Nekoliko problema stalno se pojavljuje u stvarnim popisima primatelja, obično zato što je CSV sastavljen spajanjem dvaju ili triju izvornih tablica:

• Prazni razmaci na kraju e-adresa — kopiranje iz PDF popisa ili izvoza iz Google obrasca često nosi nevidljivi razmak. Izgleda uredno u ćeliji tablice, ali ne prolazi provjeru e-adrese pri prijenosu.
• Duplicirani redovi — isti se primatelj pojavljuje dvaput jer su popis skupine i popis kasnih prijava spojeni bez uklanjanja duplikata.
• Nedosljedni formati datuma — jedan stupac s 2026-07-01 pomiješan s 07/01/2026 iz drugog izvoza. Držite se ISO 8601 (YYYY-MM-DD) i to potpuno nestaje.
• Nepodudaranja u veličini slova zaglavlja — Email naspram email naspram E-mail. Parser je popustljiv prema uobičajenim varijantama, ali potpuno prilagođeno ime zaglavlja neće se automatski mapirati.

Nijedan od tih problema nije koban — korak pretpregleda (u nastavku) iznosi svaki od njih na vidjelo prije nego što se bilo što izda, pa je popravak „uredi tablicu, ponovno prenesi” umjesto „otkrij tko je od 3.000 primatelja dobio pokvarenu značku”.

Korak 2: Konfigurirajte seriju

Na nadzornoj ploči otvorite Credentials → Bulk Credentials i odaberite značku koju izdajete. Ovo je korak u kojem postavljate sve što se odnosi na cijelu seriju: samu značku, zajednički datum izdavanja ako ne stavljate datume po redu u CSV te (ako ga vaš izdavateljski profil ima) LinkedIn organizacijski ID koji će svakom primatelju omogućiti da vjerodajnicu doda na svoj profil jednim klikom.

Ovo je dobar trenutak da još jednom provjerite je li značka koju ste odabrali konačna verzija — primatelji će vidjeti sliku i kriterije koji su joj priloženi u trenutku izdavanja, a ne ono što kasnije ažurirate.

Korak 3: Prijenos i pretpregled

Ubacite svoj CSV i platforma ga raščlanjuje, prikazuje tablicu pretpregleda i označava sve što ne može obraditi — nedostajuću e-adresu, neispravan datum, duplicirani red. Ništa se ne izdaje dok ne potvrdite pretpregled.

Ovaj korak pretpregleda važniji je nego što se čini. Tipfeler u jednom redu CSV-a od 2.000 redova lako je previdjeti okom, a mnogo je jeftinije uhvatiti ga prije nego što je 1.999 ispravnih redova već izdano nego pokušati to naknadno poništiti. Popravite označene redove u svojoj tablici, ponovno prenesite i pretpregled se ažurira.

Korak 4: Pokrenite seriju

Kliknite Izdaj i serija počinje obrađivati. Traka napretka prati dovršene naspram preostalih redova, a serija se izvodi na poslužitelju — ne morate držati karticu otvorenom, a zatvaranje prijenosnog računala usred serije ne gubi vaše mjesto.

Taj posljednji dio vrijedi jasno naglasiti jer je to detalj koji zapravo znači za velike skupine: stanje serije živi na poslužitelju, a ne u vašem pregledniku. Ako vam veza padne, prijenosno računalo zaspi ili jednostavno zatvorite karticu jer počinje sastanak, serija nastavlja s radom (ili se nastavlja točno tamo gdje je stala ako ste je pauzirali) umjesto da počne ispočetka. Za skupinu bootcampa od 40 osoba to je lijep dodatak. Za uvođenje od 5.000 redova u tvrtki to je razlika između „jednostavno radi” i „netko mora čuvati karticu preglednika dvadeset minuta”.

Možete i namjerno pauzirati seriju koja se izvodi — recimo, netko primijeti da tekst kriterija značke treba doradu na pola serije od 3.000 redova — riješite problem i nastavite bez ponovnog izdavanja redova koji su već dovršeni.

Korak 5: Rješavanje neuspjeha

Stvarni popisi primatelja imaju loše redove: e-adresu s tipfelerom u domeni, polje imena koje je zapravo prazno, dvostruki unos zbog spajanja dviju izvezenih tablica. Kad red ne uspije, serija se ne zaustavlja — nastavlja obrađivati ostatak i označava neuspjeh za naknadni pregled. Dobivate izvoz rezultata koji točno pokazuje koji su redovi uspjeli, a koji nisu, pa možete popraviti samo neuspjele redove i ponovno pokrenuti malu naknadnu seriju umjesto da ponovno provjeravate cijeli popis.

To je važno za naviku izvoza CSV-a koja je već uobičajena na nadzornoj ploči vjerodajnica — u bilo kojem trenutku možete izvući CSV onoga što je zapravo izdano, usporediti ga s izvornim popisom i točno znati kome još treba značka.

API put: isti tijek, bez nadzorne ploče

Sve navedeno pretpostavlja da netko sjedi za nadzornom pločom i prolazi kroz čarobnjaka. Ako vaši završeci već žive u nekom sustavu — LMS-u, CRM-u, automatizaciji tablice — isti tijek grupnih vjerodajnica možete voditi izravno iz Awards API-ja.

Minimalni poziv za izdavanje po primatelju izgleda ovako:

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"
  }'

Ili u Pythonu, prolazeći kroz redove pročitane iz iste CSV datoteke koju biste inače ručno prenijeli:

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,
            },
        )

Ovome vrijedi posegnuti kad izdavanje vjerodajnica pokreće nešto sasvim drugo — webhook za završetak tečaja, promjena faze u CRM-u, slanje obrasca — umjesto da osoba ručno izvozi CSV. Autentifikaciju i potpuni oblik zahtjeva/odgovora pokrivamo u brzom vodiču za API. Svaka vjerodajnica stvorena na ovaj način identična je onoj stvorenoj kroz čarobnjak na nadzornoj ploči: ista Open Badge v2.0 tvrdnja, isti URL za provjeru, ista PDF potvrda.

Čarobnjak na nadzornoj ploči naspram API-ja: što zapravo želite?

Većina timova počinje s čarobnjakom na nadzornoj ploči jer ne zahtijeva ništa osim CSV-a, a na API prelaze tek nakon što je ista serija ručno pokrenuta tri ili četiri puta i kad je obrazac očito vrijedan automatizacije.

Privatnost: što se zapravo pohranjuje

CSV s imenima i e-adresama osobni je podatak i vrijedi znati što se s njim događa nakon prijenosa. E-adresa primatelja nikad se ne pohranjuje u čistom tekstu na samoj vjerodajnici — heširana je s posebnom soli po vjerodajnici kao dio Open Badge v2.0 tvrdnje, prateći specifikacijski format identiteta primatelja hashed. Taj hash je ono što verifikator provjerava, a ne sirova adresa. Polje imena pohranjuje se onako kako je uneseno jer je namijenjeno da bude vidljivo na potvrdi i stranici za provjeru. Ako red treba ispraviti nakon izdavanja — najčešće pogrešno napisano ime — možete urediti ili opozvati pojedinačnu vjerodajnicu s nadzorne ploče vjerodajnica bez diranja ostatka serije.

Nakon serije: obavijestite primatelje

Izdavanje značke i obavještavanje primatelja o njoj dva su različita koraka. Ako vaš CSV već ne pokreće e-poštu kroz vaš vlastiti sustav, tijek grupnog dijeljenja na nadzornoj ploči omogućuje vam da višestruko odaberete vjerodajnice koje ste upravo stvorili i pošaljete personaliziranu e-poštu za dijeljenje svima njima u jednom prolazu — pogledajte grupno slanje e-pošte za dijeljenje za cijeli vodič, uključujući kako se personalizacija po primatelju (ime, slika značke, poveznica za provjeru) automatski zamjenjuje.

Kad je Bulk Credentials pravi alat

Grupno izdavanje pravi je izbor kad god okvir „serije” odgovara stvarnom svijetu: skupina koja je završila istog dana, konferencija koja je upravo završila, uvođenje obuke koje stiže do roka usklađenosti. Ako umjesto toga izdajete pojedinačne vjerodajnice kako se postižu individualne prekretnice — jedno promaknuće, jedan dovršeni projekt — obrazac za pojedinačnu vjerodajnicu brži je od sastavljanja CSV-a s jednim redom.

Za bilo što ponavljajuće — isti tečaj koji se održava svaki mjesec, tijek postupnog uvođenja — API put iznad vrijedi postaviti jednom. On pretvara „ručno pokreni grupne vjerodajnice za svaku skupinu” u „završeci već automatski izdaju vjerodajnice”, što je verzija ovog tijeka rada koju većina vlasnika programa zapravo želi nakon druge ili treće ručne serije.

Spremni izdati svoju prvu provjerljivu vjerodajnicu? Počnite besplatno na badges.ninja — vizualni dizajner, javna stranica za provjeru, PDF potvrda, Open Badge v2.0 izlaz. Nije potrebna kreditna kartica.