Kā izsniegt Open Badges no CSV faila mazāk nekā 5 minūtēs

Ja jebkad esat izsniedzis apliecinājumus grupai pa vienam saņēmējam, jūs jau zināt problēmu: tas nemērogojas tālāk par aptuveni desmit cilvēkiem, pirms pārvēršas par veselu pēcpusdienu vārdu un e-pasta adrešu kopēšanas un ielīmēšanas. 40 cilvēku bootcamp grupa, 500 konferences dalībnieku saraksts vai 5000 cilvēku korporatīvās apmācības ieviešana — visiem vajadzīgs viens un tas pats: augšupielādēt sarakstu, izvēlēties nozīmi, noklikšķināt Izsniegt un aiziet.

Tieši to arī dara Bulk Credentials vietnē https://badges.ninja. Šis ceļvedis aptver visu procesu: CSV faila sagatavošanu, partijas konfigurēšanu, tās norises novērošanu un reālās pasaules haotisko gadījumu risināšanu — saņēmēja rinda ar drukas kļūdu, partija, kas pārtrūkst pusceļā, vai programma, kas vēlas izsniegt tādā pašā veidā no savām sistēmām, nevis no vadības paneļa.

Pirms sākat: kas jums nepieciešams

Divas lietas, kuras abas jums, iespējams, jau ir:

1. Nozīme — izstrādāta vienreiz vizuālajā dizainerī un atkārtoti izmantota katram saņēmējam partijā. Ja vēl neesat nevienu izveidojis, skatiet mūsu ceļvedi par jūsu pirmā pārbaudāmā sertifikāta izstrādi.
2. Saņēmēju CSV — vārds, e-pasts un (pēc izvēles) izsniegšanas datums. Tā ir visa shēma.

Jums nav vajadzīgs izdevēja konts katram saņēmējam, pasta serveris vai jebkāds kods. Viss šajā sadaļā notiek vadības panelī.

1. solis: Sagatavojiet CSV failu

Saņēmēju saraksta formāts ir apzināti minimāls:

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 — obligāts. Aizpilda saņēmēja lauku apgalvojumā (assertion) un sertifikātā.
• email — obligāts. Tas kļūst par saņēmēja identitāti Open Badge v2.0 apgalvojumā — jaukts ar atsevišķu sāli katram apliecinājumam pirms saglabāšanas, nekad netiek glabāts vienkāršā tekstā.
• issued_on — pēc izvēles. Atstājiet tukšu, un partija izmanto brīdi, kad katra rinda tiek apstrādāta; iestatiet to skaidri, ja ar atpakaļejošu datumu aizpildāt grupu, kas patiesībā pabeidza pagājušajā mēnesī.

Lielākā daļa programmu īpašnieku to eksportē tieši no vietas, kur jau seko līdzi pabeigšanām — Airtable, Google Sheets, pasniedzēja nodota izklājlapa vai CSV, kas izvilkts no LMS atzīmju žurnāla. Nav vajadzīgs īpašs eksporta rīks; der jebkurš CSV ar šīm trim kolonnām.

Bieži CSV slazdi (un kā priekšskatījums tos noķer)

Reālajos saņēmēju sarakstos pastāvīgi parādās nedaudz problēmu, parasti tāpēc, ka CSV tika salikts kopā, apvienojot divas vai trīs avota lapas:

• Atstarpes e-pasta adrešu beigās — kopēšana no PDF saraksta vai Google veidlapas eksporta bieži nes līdzi neredzamu atstarpi. Izklājlapas šūnā tas izskatās labi, taču augšupielādes laikā neiztur e-pasta validāciju.
• Dublētas rindas — tas pats saņēmējs parādās divreiz, jo grupas saraksts un vēlo reģistrētāju saraksts tika savienoti bez dublikātu noņemšanas.
• Nekonsekventi datumu formāti — viena kolonna ar 2026-07-01, sajaukta ar 07/01/2026 no cita eksporta. Turieties pie ISO 8601 (YYYY-MM-DD), un tas pilnībā pazūd.
• Galvenu lielo un mazo burtu neatbilstības — Email pret email pret E-mail. Parsētājs ir iecietīgs pret izplatītiem variantiem, taču pilnīgi pielāgots galvenes nosaukums netiks kartēts automātiski.

Neviena no tām nav liktenīga — priekšskatījuma solis (zemāk) izceļ katru no tām, pirms kaut kas tiek izsniegts, tāpēc labojums ir “rediģē izklājlapu, augšupielādē no jauna”, nevis “noskaidro, kurš no 3000 saņēmējiem saņēma bojātu nozīmi”.

2. solis: Konfigurējiet partiju

Vadības panelī atveriet Credentials → Bulk Credentials un izvēlieties nozīmi, kuru izsniedzat. Šis ir solis, kurā iestatāt visu, kas attiecas uz visu partiju: pašu nozīmi, kopēju izsniegšanas datumu, ja CSV neievietojat datumus katrai rindai, un (ja jūsu izdevēja profilam tāds ir) LinkedIn organizācijas ID, kas ļaus katram saņēmējam pievienot apliecinājumu savam profilam ar vienu klikšķi.

Šis ir labs brīdis vēlreiz pārbaudīt, vai izvēlētā nozīme ir galīgā versija — saņēmēji redzēs attēlu un kritērijus, kas tai piesaistīti izsniegšanas brīdī, nevis to, ko atjaunināsiet vēlāk.

3. solis: Augšupielādējiet un priekšskatiet

Iemetiet savu CSV, un platforma to parsē, parāda jums priekšskatījuma tabulu un atzīmē visu, ko tā nevar apstrādāt — trūkstošu e-pastu, nepareizu datumu, dublētu rindu. Nekas netiek izsniegts, kamēr jūs neapstiprināt priekšskatījumu.

Šis priekšskatījuma solis ir svarīgāks, nekā izskatās. Drukas kļūdu vienā 2000 rindu CSV rindā ar acīm ir viegli palaist garām, un ir daudz lētāk to noķert, pirms 1999 pareizas rindas jau ir izsniegtas, nekā mēģināt to pēc tam atritināt. Izlabojiet atzīmētās rindas savā izklājlapā, augšupielādējiet no jauna, un priekšskatījums atjaunināsies.

4. solis: Palaidiet partiju

Nospiediet Izsniegt, un partija sāk apstrādi. Progresa josla seko līdzi pabeigtajām un atlikušajām rindām, un partija darbojas servera pusē — jums nav jātur cilne atvērta, un klēpjdatora aizvēršana partijas vidū nezaudē jūsu vietu.

Šo pēdējo daļu ir vērts skaidri pateikt, jo tieši šī detaļa lielām grupām patiešām ir svarīga: partijas stāvoklis dzīvo serverī, nevis jūsu pārlūkā. Ja jūsu savienojums pārtrūkst, klēpjdators aizmieg vai jūs vienkārši aizverat cilni, jo sākas sapulce, partija turpina darboties (vai atsākas tieši tur, kur tā apstājās, ja to pauzējāt), nevis sākas no nulles. 40 cilvēku bootcamp grupai tas ir jauks papildinājums. 5000 rindu korporatīvai ieviešanai tā ir atšķirība starp “tas vienkārši darbojas” un “kādam divdesmit minūtes jāaukļē pārlūka cilne”.

Darbojošos partiju varat arī apzināti pauzēt — teiksim, kāds norāda, ka nozīmes kritēriju teksts 3000 rindu partijas vidū ir jāpiekoriģē — izlabojiet problēmu un turpiniet, atkārtoti neizsniedzot jau pabeigtās rindas.

5. solis: Rīkojieties ar neveiksmēm

Reālajos saņēmēju sarakstos ir sliktas rindas: e-pasts ar drukas kļūdu domēnā, vārda lauks, kas patiesībā ir tukšs, dublēts ieraksts no divu eksportētu lapu apvienošanas. Kad rinda neizdodas, partija neapstājas — tā turpina apstrādāt pārējo un atzīmē neveiksmi vēlākai pārskatīšanai. Jūs saņemat rezultātu eksportu, kas precīzi parāda, kuras rindas izdevās un kuras ne, tāpēc varat izlabot tikai neizdevušās rindas un palaist nelielu papildu partiju, nevis pārbaudīt visu sarakstu no jauna.

Tas ir svarīgi CSV eksporta ieradumam, kas jau ir izplatīts apliecinājumu vadības panelī — jebkurā brīdī varat izvilkt CSV par to, kas patiesībā tika izsniegts, salīdzināt to ar savu avota sarakstu un precīzi zināt, kam vēl vajadzīga nozīme.

API ceļš: tas pats process, bez vadības paneļa

Viss iepriekšminētais pieņem, ka kāds sēž pie vadības paneļa un klikšķina cauri vednim. Ja jūsu pabeigšanas dati jau dzīvo sistēmā — LMS, CRM, izklājlapu automatizācijā — jūs varat vadīt to pašu masveida apliecinājumu procesu tieši no Awards API.

Minimāls izsniegšanas izsaukums vienam saņēmējam izskatās šādi:

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

Vai Python valodā, iterējot cauri rindām, kas nolasītas no tā paša CSV, kuru citādi augšupielādētu ar roku:

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

Pēc tā ir vērts ķerties, kad apliecinājumu izsniegšanu izraisa kaut kas pavisam cits — kursa pabeigšanas tīmekļa āķis, CRM posma maiņa, veidlapas iesniegšana — nevis cilvēks, kas manuāli eksportē CSV. Autentifikāciju un pilno pieprasījuma/atbildes formu aptveram API ātrajā ceļvedī. Katrs šādi izveidots apliecinājums ir identisks tam, kas izveidots caur vadības paneļa vedni: tas pats Open Badge v2.0 apgalvojums, tā pati pārbaudes URL, tas pats PDF sertifikāts.

Vadības paneļa vednis pret API: kuru jūs patiesībā vēlaties?

Lielākā daļa komandu sāk ar vadības paneļa vedni, jo tam nav vajadzīgs nekas cits kā CSV, un pāriet uz API tikai tad, kad tā pati partija ir palaista manuāli trīs vai četras reizes un šablonu acīmredzami ir vērts automatizēt.

Privātums: kas patiesībā tiek saglabāts

CSV ar vārdiem un e-pastiem ir personas dati, un ir vērts zināt, kas ar tiem notiek pēc augšupielādes. Saņēmēja e-pasta adrese nekad netiek saglabāta vienkāršā tekstā pašā apliecinājumā — tā tiek jaukta ar atsevišķu sāli katram apliecinājumam kā Open Badge v2.0 apgalvojuma daļa, ievērojot specifikācijas hashed saņēmēja identitātes formātu. Tieši šo jaucējvērtību verificētājs pārbauda, nevis neapstrādāto adresi. Vārda lauks tiek saglabāts tā, kā ievadīts, jo tam paredzēts būt redzamam sertifikātā un pārbaudes lapā. Ja rinda pēc izsniegšanas jālabo — visbiežāk nepareizi uzrakstīts vārds — jūs varat rediģēt vai atsaukt atsevišķu apliecinājumu no apliecinājumu vadības paneļa, neaizskarot pārējo partiju.

Pēc partijas: paziņojiet saņēmējiem

Nozīmes izsniegšana un saņēmēja informēšana par to ir divi dažādi soļi. Ja jūsu CSV jau neaktivizē e-pastu caur jūsu paša sistēmu, vadības paneļa masveida kopīgošanas process ļauj jums vairākkārt atlasīt tikko izveidotos apliecinājumus un nosūtīt personalizētu kopīgošanas e-pastu tiem visiem vienā piegājienā — skatiet kopīgošanas e-pastu masveida sūtīšanu, lai iegūtu pilnu ceļvedi, tostarp to, kā katra saņēmēja personalizācija (vārds, nozīmes attēls, pārbaudes saite) tiek automātiski aizstāta.

Kad Bulk Credentials ir īstais rīks

Masveida izsniegšana ir pareizā izvēle vienmēr, kad “partijas” ietvars atbilst reālajai pasaulei: grupa, kas pabeidza vienā dienā, konference, kas tikko beidzās, apmācības ieviešana, kas tuvojas atbilstības termiņam. Ja tā vietā izsniedzat vienreizējus apliecinājumus, sasniedzot atsevišķus atskaites punktus — viena paaugstinājuma, viena pabeigta projekta — viena apliecinājuma veidlapa ir ātrāka nekā vienas rindas CSV salikšana.

Jebkam atkārtotam — tas pats kurss, kas notiek katru mēnesi, ritošs adaptācijas cauruļvads — augstāk minēto API ceļu ir vērts iestatīt vienreiz. Tas pārvērš “palaid masveida apliecinājumus manuāli katrai grupai” par “pabeigšanas jau izsniedz apliecinājumus automātiski”, kas ir šī darbplūsmas versija, ko lielākā daļa programmu īpašnieku pēc otrās vai trešās manuālās partijas patiesībā vēlas.

Vai esat gatavi izsniegt savu pirmo pārbaudāmo apliecinājumu? Sāciet bez maksas vietnē badges.ninja — vizuālais dizainers, publiska pārbaudes lapa, PDF sertifikāts, Open Badge v2.0 izvade. Kredītkarte nav nepieciešama.