API za izdavatelje

Upravljajte izdavateljima značaka — organizacijama ili pojedincima koji izdaju značke.

Svi endpointi zahtijevaju autentifikaciju putem zaglavlja X-Api-Key. Pogledajte Autentifikaciju.

Izrada izdavatelja

Izradite novog izdavatelja značaka.

POST /issuers

Parametri

Parametar	Tip	Obvezno	Opis
name	string	Da	Naziv organizacije (najmanje 3 znaka)
url	string	Da	Web-stranica organizacije (mora biti valjan HTTP/HTTPS URL)
email	string	Da	Kontaktna e-mail adresa izdavatelja
logo	string	Ne	Slika kodirana u Base64 (PNG ili JPG)
linkedinOrganizationId	string	Ne	Numerički ID LinkedIn stranice tvrtke. Kad je postavljen, svaka javna stranica vjerodajnice ovog izdavatelja prikazuje gumb Add to LinkedIn Profile.

Primjer

curl -X POST https://api.badges.ninja/issuers \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "parameters": {
      "name": "Acme Academy",
      "url": "https://acme.example.com",
      "email": "badges@acme.example.com"
    }
  }'

Odgovor

{
  "issuerId": "https://api.badges.ninja/certify-badge/issuer/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Napomene

• Ulazi u ograničenje izdavatelja vašeg plana (Free: 2, Starter: 5, Pro: 10). Kvota se ne troši.
• Ako se e-mail izdavatelja podudara s e-mailom vašeg računa, izdavatelj se automatski provjerava.
• Ako je e-mail drukčiji, na e-mail izdavatelja šalje se poruka za provjeru.
• Nakon postavljanja izdavatelja upotrijebite API za vjerodajnice kako biste počeli izdavati vjerodajnice pod tim izdavateljem.

---

Popis izdavatelja

Dohvatite sve izdavatelje koje ste izradili.

GET /issuers

Primjer

curl -X GET https://api.badges.ninja/issuers \
  -H "X-Api-Key: bws_your_api_key_here"

Odgovor

{
  "items": [
    {
      "id": "https://api.badges.ninja/certify-badge/issuer/a1b2c3d4-...",
      "name": "Acme Academy",
      "url": "https://acme.example.com",
      "email": "badges@acme.example.com",
      "verified": true,
      "timestamp": 1736937000000
    }
  ]
}

timestamp je Unix epoha u milisekundama. Kad postoji više izdavatelja nego što stane na jednu stranicu, za straničenje se vraća i lastEvaluatedKey.

---

Provjera izdavatelja

Provjerite izdavatelja kodom za provjeru poslanim na njegov e-mail.

POST /issuers/{issuerId}/verify

Parametri

Parametar	Tip	Obvezno	Opis
issuerId	string	Da	ID izdavatelja (parametar putanje)
code	string	Da	Kod za provjeru iz e-maila

Primjer

curl -X POST https://api.badges.ninja/issuers/a1b2c3d4-e5f6-7890-abcd-ef1234567890/verify \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "parameters": {
      "issuerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "code": "ABC123"
    }
  }'

Odgovor

Običan string:

"issuer has been verified"

---

Brisanje izdavatelja

Izbrišite izdavatelja. S izdavateljem ne smije biti povezana nijedna značka.

DELETE /issuers/{issuerId}

Primjer

curl -X DELETE https://api.badges.ninja/issuers/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-Api-Key: bws_your_api_key_here"

Odgovor

Običan string:

"issuer has been deleted"

Pogreške

• 400 — izdavatelj još ima povezane značke: issuer has {n} badge(s) linked — delete the badges first. Brisanje ovisi samo o povezanim značkama — vjerodajnice ga ne blokiraju.
• 404 — izdavatelj nije pronađen

---

Ažuriranje izdavatelja

Ažurirajte polja izdavatelja. Mogu se uređivati samo neprovjereni izdavatelji — nakon što je izdavatelj provjeren, ovaj endpoint vraća 400 verified issuers cannot be edited radi očuvanja stabilnosti vjerodajnica. Uređivanje izdavatelja ponovno generira njegov kod za provjeru: ako se email podudara s e-mailom vašeg računa, izdavatelj se automatski ponovno provjerava, a inače se na tu adresu šalje nova poruka za provjeru.

PUT /issuers/{issuerId}

Parametri

Parametar	Tip	Obvezno	Opis
issuerId	string	Da	ID izdavatelja (parametar putanje)
name	string	Ne	Novi naziv
url	string	Ne	Novi URL
email	string	Ne	Novi e-mail (šalje novu poruku za provjeru osim ako se podudara s e-mailom vašeg računa)
logo	string	Ne	Novi logotip kodiran u Base64
linkedinOrganizationId	string	Ne	Novi ID LinkedIn organizacije (ili prazan string za brisanje)

Odgovor

{
  "issuerId": "https://api.badges.ninja/certify-badge/issuer/a1b2c3d4-...",
  "updated": true
}

Pogreške

• 400 — verified issuers cannot be edited (izdavatelj je već provjeren)
• 400 — not authorized (izdavatelj pripada drugom računu)
• 404 — izdavatelj nije pronađen