Hogyan adj ki Open Badges jelvényeket CSV-ből 5 percen belül

Ha valaha is adtál ki egy csoportnak igazolásokat egyesével, címzettenként, akkor már ismered a problémát: nagyjából tíz ember fölött nem skálázódik, mielőtt egy egész délutánná válna a nevek és e-mailek másolgatása és beillesztése. Egy 40 fős bootcamp-csoport, egy 500 fős konferencia-résztvevői lista vagy egy 5000 fős vállalati képzés bevezetése mind ugyanazt igényli — feltöltesz egy listát, kiválasztasz egy jelvényt, a Kiadásra kattintasz és elsétálsz.

Pontosan ezt csinálja a Tömeges igazolások a https://badges.ninja oldalon. Ez a végigvezetés a teljes folyamatot lefedi: a CSV előkészítését, a köteg beállítását, a futásának figyelését és a valós élet zűrös eseteinek kezelését — egy elgépelt címzett-sort, egy félúton megszakadt köteget, vagy egy programot, amely a saját rendszereiből akar ugyanígy kiadni, nem a vezérlőpultról.

Mielőtt belekezdesz: mire van szükséged

Két dologra, amelyek mindegyike valószínűleg már megvan neked:

1. Egy jelvényre — egyszer megtervezve a vizuális tervezőben, majd újrahasználva a köteg minden címzettjéhez. Ha még nem építettél egyet sem, nézd meg útmutatónkat az első ellenőrizhető tanúsítványod megtervezéséről.
2. Egy CSV-re a címzettekkel — név, e-mail és (opcionálisan) egy kiadási dátum. Ez a teljes séma.

Nincs szükséged címzettenkénti kibocsátói fiókra, levelezőszerverre vagy bármilyen kódra. Ebben a szakaszban minden a vezérlőpulton történik.

1. lépés: készítsd elő a CSV-t

A címzettlista formátuma szándékosan minimális:

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 — kötelező. Kitölti a címzett mezőt az állításban és a tanúsítványon.
• email — kötelező. Ez lesz a címzett azonossága az Open Badge v2.0 állításban — tárolás előtt igazolásonkénti sóval hasheljük, soha nem tartjuk meg egyszerű szövegként.
• issued_on — opcionális. Hagyd üresen, és a köteg az egyes sorok feldolgozásának pillanatát használja; add meg kifejezetten, ha egy olyan csoportot pótolsz visszamenőleg, amely valójában a múlt hónapban végzett.

A legtöbb programtulajdonos ezt egyenesen onnan exportálja, ahol amúgy is nyomon követi a teljesítéseket — az Airtable-ből, a Google Sheetsből, egy oktató által átadott táblázatból vagy egy LMS osztálykönyvéből lehúzott CSV-ből. Nincs szükség semmilyen speciális exporteszközre; bármely CSV működik ezzel a három oszloppal.

Gyakori CSV-buktatók (és hogyan kapja el őket az előnézet)

Egy maréknyi probléma folyamatosan felbukkan a valós címzettlistákban, általában azért, mert a CSV-t két-három forrástábla összefűzésével állították össze:

• Záró szóközök az e-mail-címekben — egy PDF-névsorból vagy egy Google Form-exportból való másolás-beillesztés gyakran magával hoz egy láthatatlan szóközt. Egy táblázatcellában rendben néz ki, de feltöltéskor megbukik az e-mail-ellenőrzésen.
• Ismétlődő sorok — ugyanaz a címzett kétszer jelenik meg, mert egy csoportlistát és egy későn jelentkezők listáját deduplikálás nélkül fűztek össze.
• Következetlen dátumformátumok — egy 2026-07-01 oszlop keveredve egy másik exportból származó 07/01/2026 értékekkel. Maradj az ISO 8601-nél (YYYY-MM-DD), és ez teljesen eltűnik.
• Kis- és nagybetű eltérések a fejlécekben — Email kontra email kontra E-mail. Az elemző elnéző a gyakori változatokkal szemben, de egy teljesen egyedi fejlécnév nem képződik le automatikusan.

Ezek egyike sem végzetes — az előnézeti lépés (lentebb) mindegyiket felszínre hozza, mielőtt bármit kiadnánk, így a javítás „szerkeszd a táblázatot, tölts fel újra”, nem pedig „derítsd ki, a 3000 címzett közül melyik kapott hibás jelvényt”.

2. lépés: állítsd be a köteget

A vezérlőpulton nyisd meg az Igazolások → Tömeges igazolások menüt, és válaszd ki a kiadandó jelvényt. Ez az a lépés, ahol beállítasz mindent, ami a teljes kötegre vonatkozik: magát a jelvényt, egy közös kiadási dátumot, ha nem soronkénti dátumokat teszel a CSV-be, és (ha a kibocsátói profilodhoz tartozik ilyen) a LinkedIn-szervezet azonosítóját, amely minden címzettnek lehetővé teszi, hogy egyetlen kattintással hozzáadja az igazolást a profiljához.

Ez jó pillanat arra, hogy még egyszer ellenőrizd, a kiválasztott jelvény a végleges verzió — a címzettek azt a képet és azokat a kritériumokat fogják látni, amelyek a kiadás pillanatában hozzá vannak csatolva, nem azt, amit később frissítesz benne.

3. lépés: tölts fel és nézd meg az előnézetet

Húzd be a CSV-t, a platform pedig elemzi, megmutat egy előnézeti táblázatot, és megjelöl mindent, amit nem tud feldolgozni — egy hiányzó e-mailt, egy hibás dátumot, egy ismétlődő sort. Semmi sem kerül kiadásra, amíg meg nem erősíted az előnézetet.

Ez az előnézeti lépés többet számít, mint amennyinek látszik. Egy 2000 soros CSV egyetlen sorában lévő elgépelést szemmel könnyű elnézni, és sokkal olcsóbb elkapni, mielőtt 1999 helyes sor már kiadásra került, mint utólag próbálni visszabontani. Javítsd ki a megjelölt sorokat a táblázatban, tölts fel újra, és az előnézet frissül.

4. lépés: futtasd a köteget

Kattints a Kiadásra, és a köteg elkezdi a feldolgozást. Egy folyamatjelző követi az elkészült és a hátralévő sorokat, a köteg pedig a szerver oldalán fut — nem kell nyitva tartanod a fület, és a laptop lecsukása a köteg közepén nem veszíti el a helyedet.

Ezt az utóbbit érdemes kimondani, mert ez az a részlet, ami nagy csoportoknál igazán számít: a köteg állapota a szerveren él, nem a böngésződben. Ha megszakad a kapcsolatod, a laptopod elalszik, vagy egyszerűen bezárod a fület, mert kezdődik egy megbeszélés, a köteg tovább fut (vagy pontosan onnan folytatódik, ahol szüneteltetted) ahelyett, hogy nulláról indulna újra. Egy 40 fős bootcamp-csoportnál ez kellemes ráadás. Egy 5000 soros vállalati bevezetésnél ez a különbség „egyszerűen működik” és „valakinek húsz percig egy böngészőfület kell pesztrálnia” között.

Egy futó köteget szándékosan is szüneteltethetsz — mondjuk valaki jelzi, hogy a jelvény kritériumszövege igazításra szorul egy 3000 soros futás közepén — kijavíthatod a problémát, és folytathatod anélkül, hogy újra kiadnád a már elkészült sorokat.

5. lépés: kezeld a hibákat

A valós címzettlistákban vannak rossz sorok: egy elgépelt e-mail-domain, egy név mező, ami valójában üres, egy ismétlődő bejegyzés két exportált tábla összefésüléséből. Amikor egy sor meghiúsul, a köteg nem áll le — feldolgozza a többit, és a hibát megjelöli utólagos áttekintésre. Kapsz egy eredmény-exportot, amely pontosan megmutatja, mely sorok jártak sikerrel és melyek nem, így csak a hibás sorokat javíthatod ki, és egy kis utókötegben futtathatod újra ahelyett, hogy az egész listát újra átnéznéd.

Ez fontos a CSV-exportálás szokásához, amely már bevett az igazolások vezérlőpultján — bármikor lehúzhatsz egy CSV-t arról, ami ténylegesen kiadásra került, összevetheted a forráslistáddal, és pontosan tudhatod, kinek van még szüksége jelvényre.

Az API-út: ugyanaz a folyamat, vezérlőpult nélkül

A fentiek mind azt feltételezik, hogy valaki a vezérlőpultnál ül, és végigkattint a varázslón. Ha a teljesítéseid már egy rendszerben élnek — egy LMS-ben, egy CRM-ben, egy táblázat-automatizálásban — ugyanazt a tömeges igazolási folyamatot közvetlenül az Awards API-ból is vezérelheted.

Egy minimális, címzettenkénti kiadási hívás így néz ki:

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

Vagy Pythonban, végigiterálva ugyanannak a CSV-nek a sorain, amelyet egyébként kézzel töltenél fel:

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

Ehhez érdemes nyúlni, amikor az igazolás kiadását valami egészen más váltja ki — egy kurzusteljesítési webhook, egy CRM-fázisváltás, egy űrlapbeküldés — nem pedig egy ember, aki kézzel exportál egy CSV-t. A hitelesítést és a teljes kérés/válasz szerkezetet az API gyorsindítóban tárgyaljuk. Minden így létrehozott igazolás azonos a vezérlőpult varázslójával létrehozottal: ugyanaz az Open Badge v2.0 állítás, ugyanaz az ellenőrzési URL, ugyanaz a PDF-tanúsítvány.

Vezérlőpult-varázsló kontra API: melyikre van valójában szükséged?

A legtöbb csapat a vezérlőpult varázslójával kezd, mert az egy CSV-n kívül semmit sem igényel, és csak akkor tér át az API-ra, miután ugyanazt a köteget háromszor-négyszer kézzel lefuttatták, és a minta láthatóan megéri az automatizálást.

Adatvédelem: mi tárolódik valójában

Egy neveket és e-maileket tartalmazó CSV személyes adat, és érdemes tudni, mi történik vele a feltöltés után. A címzett e-mail-címét soha nem tároljuk egyszerű szövegként magán az igazoláson — igazolásonkénti sóval hasheljük az Open Badge v2.0 állítás részeként, a specifikáció hashed címzettazonossági formátumát követve. Egy ellenőrző ezt a hasht veti össze, nem a nyers címet. A név mezőt a beírt formában tároljuk, mivel az arra szolgál, hogy látható legyen a tanúsítványon és az ellenőrzési oldalon. Ha egy sort a kiadás után javítani kell — leggyakrabban egy elgépelt nevet — az egyes igazolást szerkesztheted vagy visszavonhatod az igazolások vezérlőpultjáról anélkül, hogy a köteg többi részéhez hozzányúlnál.

A köteg után: értesítsd a címzetteket

A jelvény kiadása és a címzett értesítése róla két különböző lépés. Ha a CSV-d nem vált ki már eleve egy e-mailt a saját rendszereden keresztül, a vezérlőpult tömeges megosztási folyamata lehetővé teszi, hogy több, épp létrehozott igazolást kijelölj, és egyetlen menetben mindegyiküknek elküldj egy személyre szabott megosztási e-mailt — lásd a megosztási e-mailek tömeges küldését a teljes végigvezetésért, beleértve azt is, hogyan helyettesítődik be automatikusan a címzettenkénti személyre szabás (név, jelvénykép, ellenőrzési link).

Mikor a Tömeges igazolások a megfelelő eszköz

A tömeges kiadás akkor a helyes választás, amikor a „köteg” keret illik a valós világra: egy csoport, amely ugyanazon a napon végzett, egy konferencia, amely épp lezárult, egy képzési bevezetés, amely egy megfelelőségi határidőt céloz. Ha viszont egyszeri igazolásokat adsz ki, ahogy egyedi mérföldkövek teljesülnek — egyetlen előléptetés, egyetlen projekt befejezése — az egyetlen igazolás űrlap gyorsabb, mint összeállítani egy egysoros CSV-t.

Bármi ismétlődőre — ugyanaz a kurzus, amely havonta fut, egy folyamatos onboarding-folyamat — a fenti API-utat érdemes egyszer beállítani. A „futtass tömeges igazolásokat kézzel minden csoportnál” helyett „a teljesítések már automatikusan igazolásokat adnak ki” lesz belőle, ami ennek a munkafolyamatnak az a verziója, amelyet a legtöbb programtulajdonos a második vagy harmadik kézi köteg után valójában szeretne.

Készen állsz kiadni az első ellenőrizhető igazolásodat? Kezdd ingyen a badges.ninja-n — vizuális tervező, nyilvános ellenőrzési oldal, PDF-tanúsítvány, Open Badge v2.0 kimenet. Bankkártya nem szükséges.