Jak vydávat Open Badges z CSV za méně než 5 minut

Pokud jste někdy vydávali přihlašovací údaje skupině po jednom příjemci, už ten problém znáte: neškáluje se za hranici zhruba deseti lidí, než se to promění v odpoledne strávené kopírováním a vkládáním jmen a e-mailů. Čtyřicetičlenná skupina bootcampu, seznam 500 účastníků konference nebo zavádění firemního školení pro 5 000 lidí — všichni potřebují totéž: nahrát seznam, vybrat odznak, kliknout na Vydat a odejít.

Přesně to dělají Hromadné přihlašovací údaje na https://badges.ninja. Tento návod pokrývá celý postup: přípravu vašeho CSV, konfiguraci dávky, sledování jejího průběhu a řešení chaotických případů z reálného světa — řádek příjemce s překlepem, dávku přerušenou v polovině nebo program, který chce vydávat stejným způsobem z vlastních systémů, a ne z nástěnky.

Než začnete: co potřebujete

Dvě věci, které pravděpodobně obě už máte:

1. Odznak — navržený jednou ve vizuálním návrháři, znovu použitý pro každého příjemce v dávce. Pokud jste ještě žádný nevytvořili, podívejte se na našeho průvodce návrhem vašeho prvního ověřitelného certifikátu.
2. CSV s příjemci — jméno, e-mail a (volitelně) datum vydání. To je celé schéma.

Nepotřebujete účet vydavatele pro každého příjemce, poštovní server ani žádný kód. Vše v této části probíhá na nástěnce.

Krok 1: připravte své CSV

Formát seznamu příjemců je záměrně minimální:

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 — povinné. Vyplňuje pole příjemce v asserci a na certifikátu.
• email — povinný. Stává se identitou příjemce v asserci Open Badge v2.0 — před uložením zahašovaný se solí přidělenou danému přihlašovacímu údaji, nikdy uchovávaný v otevřené podobě.
• issued_on — volitelné. Nechte prázdné a dávka použije okamžik zpracování každého řádku; nastavte explicitně, pokud zpětně doplňujete skupinu, která ve skutečnosti skončila minulý měsíc.

Většina vlastníků programů to exportuje přímo odtud, kde stejně dokončení sledují — z Airtable, Tabulek Google, tabulky předané lektorem nebo z CSV staženého z klasifikačního systému LMS. Není potřeba žádný speciální exportní nástroj; funguje jakékoli CSV s těmito třemi sloupci.

Časté nástrahy CSV (a jak je náhled zachytí)

Hrstka problémů se v reálných seznamech příjemců objevuje neustále, obvykle proto, že CSV vzniklo sloučením dvou nebo tří zdrojových listů:

• Koncové mezery v e-mailových adresách — kopírování z PDF seznamu nebo z exportu Google Form s sebou často nese neviditelnou mezeru. V buňce tabulky vypadá v pořádku, ale při nahrávání neprojde ověřením e-mailu.
• Duplicitní řádky — tentýž příjemce se objeví dvakrát, protože seznam skupiny a seznam pozdních přihlášek byly slepeny bez odstranění duplicit.
• Nekonzistentní formáty dat — jeden sloupec 2026-07-01 smíchaný s 07/01/2026 z jiného exportu. Držte se ISO 8601 (YYYY-MM-DD) a tohle zmizí úplně.
• Nesoulad velikosti písmen v záhlaví — Email versus email versus E-mail. Parser je vůči běžným variantám shovívavý, ale zcela vlastní název záhlaví se nenamapuje automaticky.

Nic z toho není fatální — krok náhledu (níže) každý z nich odhalí dříve, než se cokoli vydá, takže oprava zní „upravte tabulku, nahrajte znovu“, a ne „zjistěte, který z 3 000 příjemců dostal rozbitý odznak“.

Krok 2: nakonfigurujte dávku

Na nástěnce otevřete Přihlašovací údaje → Hromadné přihlašovací údaje a vyberte odznak, který vydáváte. Toto je krok, kde nastavíte vše, co platí pro celou dávku: samotný odznak, sdílené datum vydání, pokud do CSV nedáváte data pro jednotlivé řádky, a (pokud jej váš profil vydavatele má) ID organizace LinkedIn, které každému příjemci umožní přidat přihlašovací údaj do profilu jedním kliknutím.

Tohle je vhodná chvíle znovu zkontrolovat, že vybraný odznak je konečná verze — příjemci uvidí takový obrázek a kritéria, jaké jsou k němu připojeny v okamžiku vydání, ne to, co k němu aktualizujete později.

Krok 3: nahrajte a zobrazte náhled

Přetáhněte své CSV dovnitř a platforma jej zparsuje, ukáže vám tabulku náhledu a označí vše, co nedokáže zpracovat — chybějící e-mail, špatně formátované datum, duplicitní řádek. Nic se nevydá, dokud náhled nepotvrdíte.

Tento krok náhledu je důležitější, než se zdá. Překlep v jednom řádku CSV o 2 000 řádcích se okem snadno přehlédne a je mnohem levnější jej zachytit dřív, než je už vydáno 1 999 správných řádků, než se to pak snažit rozmotat. Opravte označené řádky v tabulce, nahrajte znovu a náhled se aktualizuje.

Krok 4: spusťte dávku

Klikněte na Vydat a dávka se začne zpracovávat. Ukazatel průběhu sleduje dokončené řádky oproti zbývajícím a dávka běží na straně serveru — nemusíte držet záložku otevřenou a zavření notebooku uprostřed dávky vám neztratí místo.

Tuhle poslední část stojí za to říct výslovně, protože je to detail, na kterém u velkých skupin skutečně záleží: stav dávky žije na serveru, ne ve vašem prohlížeči. Pokud vám vypadne připojení, notebook usne nebo prostě zavřete záložku, protože začíná porada, dávka běží dál (nebo se obnoví přesně tam, kde jste ji pozastavili) místo restartu od nuly. Pro čtyřicetičlennou skupinu bootcampu je to příjemná drobnost. U firemního zavádění o 5 000 řádcích je to rozdíl mezi „prostě to funguje“ a „někdo musí dvacet minut hlídat záložku prohlížeče“.

Běžící dávku můžete také záměrně pozastavit — dejme tomu, že někdo upozorní, že text kritérií odznaku potřebuje uprostřed běhu o 3 000 řádcích úpravu — problém opravit a obnovit ji bez opětovného vydání již dokončených řádků.

Krok 5: vyřešte neúspěchy

Reálné seznamy příjemců mají špatné řádky: e-mailovou doménu s překlepem, pole jména, které je vlastně prázdné, duplicitní záznam ze sloučení dvou exportovaných listů. Když řádek selže, dávka se nezastaví — pokračuje ve zpracování zbytku a neúspěch označí k pozdějšímu přezkoumání. Dostanete export výsledků, který přesně ukazuje, které řádky uspěly a které ne, takže můžete opravit jen neúspěšné řádky a spustit malou navazující dávku místo kontroly celého seznamu znovu.

To je důležité pro zvyk exportovat CSV, který je už na nástěnce přihlašovacích údajů běžný — kdykoli si můžete vytáhnout CSV toho, co bylo skutečně vydáno, porovnat je se svým zdrojovým seznamem a přesně vědět, kdo ještě odznak potřebuje.

Cesta přes API: stejný postup, žádná nástěnka

Vše výše předpokládá, že u nástěnky sedí někdo, kdo proklikává průvodce. Pokud vaše dokončení už žijí v nějakém systému — LMS, CRM, automatizaci tabulek — můžete tentýž postup hromadných přihlašovacích údajů řídit přímo z Awards API.

Minimální volání vydání pro jednoho příjemce vypadá takto:

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

Nebo v Pythonu, v cyklu přes řádky načtené ze stejného CSV, které byste jinak nahrávali ručně:

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

Po tomto stojí za to sáhnout, když vydání přihlašovacích údajů spouští něco úplně jiného — webhook dokončení kurzu, změna fáze v CRM, odeslání formuláře — a ne člověk ručně exportující CSV. Autentizaci a úplnou podobu požadavku/odpovědi rozebíráme v rychlém startu API. Každý takto vytvořený přihlašovací údaj je totožný s tím vytvořeným průvodcem na nástěnce: stejná asserce Open Badge v2.0, stejná ověřovací URL, stejný PDF certifikát.

Průvodce na nástěnce vs. API: co vlastně chcete?

Většina týmů začíná průvodcem na nástěnce, protože nevyžaduje nic kromě CSV, a k API přechází teprve poté, co tutéž dávku spustili ručně třikrát nebo čtyřikrát a vzorec si zjevně zaslouží automatizaci.

Soukromí: co se vlastně ukládá

CSV se jmény a e-maily jsou osobní údaje a stojí za to vědět, co se s nimi po nahrání děje. E-mailová adresa příjemce se na samotném přihlašovacím údaji nikdy neukládá v otevřené podobě — je zahašovaná se solí přidělenou danému přihlašovacímu údaji jako součást asserce Open Badge v2.0, podle formátu identity příjemce hashed ze specifikace. Právě tento hash ověřovatel kontroluje, ne surovou adresu. Pole jména se ukládá tak, jak bylo zadáno, protože má být viditelné na certifikátu a na ověřovací stránce. Pokud řádek po vydání potřebuje opravu — nejčastěji chybně napsané jméno — můžete jednotlivý přihlašovací údaj upravit nebo odvolat z nástěnky přihlašovacích údajů, aniž byste se dotkli zbytku dávky.

Po dávce: uvědomte příjemce

Vydat odznak a říct o něm příjemci jsou dva různé kroky. Pokud vaše CSV už nespouští e-mail přes váš vlastní systém, hromadný sdílecí postup na nástěnce vám umožní vybrat více právě vytvořených přihlašovacích údajů a poslat jim všem personalizovaný sdílecí e-mail v jednom průchodu — viz hromadné odesílání sdílecích e-mailů pro úplný návod, včetně toho, jak se personalizace pro každého příjemce (jméno, obrázek odznaku, ověřovací odkaz) dosazuje automaticky.

Kdy jsou Hromadné přihlašovací údaje ten správný nástroj

Hromadné vydávání je správná volba pokaždé, když rámec „dávky“ sedí na reálný svět: skupina, která skončila tentýž den, konference, která právě skončila, zavádění školení mířící na termín souladu. Pokud naopak vydáváte jednorázové přihlašovací údaje, jak se dosahují jednotlivé milníky — jedno povýšení, dokončení jednoho projektu — je formulář pro jednotlivý přihlašovací údaj rychlejší než sestavovat jednořádkové CSV.

U čehokoli opakujícího se — tentýž kurz běžící každý měsíc, průběžný onboardingový tok — stojí za to výše uvedenou cestu přes API nastavit jednou. Změní „spouštěj hromadné přihlašovací údaje ručně pro každou skupinu“ na „dokončení už vydávají přihlašovací údaje automaticky“, což je verze tohoto pracovního postupu, kterou většina vlastníků programů po druhé nebo třetí ruční dávce skutečně chce.

Připraveni vydat svůj první ověřitelný přihlašovací údaj? Začněte zdarma na badges.ninja — vizuální návrhář, veřejná ověřovací stránka, PDF certifikát, výstup Open Badge v2.0. Kreditní karta není potřeba.