Issuers API

Upravljajte izdavateljima bedževa — organizacijama ili pojedincima koji dodjeljuju bedževe.

Svi endpointi zahtijevaju autentifikaciju preko zaglavlja X-Api-Key. Pogledajte Autentifikacija.

Stvori izdavatelja

Stvorite novog izdavatelja bedževa.

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	Kontakt e-pošta izdavatelja
logo	string	Ne	Slika kodirana u Base64 (PNG ili JPG)
linkedinOrganizationId	string	Ne	Brojčani ID stranice tvrtke na LinkedIn. Kad je postavljen, svaka javna stranica dodjele od 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

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

Napomene

• Broji se prema ograničenju izdavatelja vašeg plana (Free: 1, Starter: 5, Pro: neograničeno). Bez odbitka kvote.
• Ako se e-pošta izdavatelja podudara s e-poštom vašeg računa, izdavatelj se automatski provjerava.
• Ako je e-pošta drugačija, na e-poštu izdavatelja šalje se poruka za provjeru.

---

Popiši izdavatelje

Dohvatite sve izdavatelje koje ste stvorili.

GET /issuers

Primjer

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

Odgovor

{
  "statusCode": 200,
  "info": {
    "issuers": [
      {
        "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": "2025-01-15T10:30:00.000Z"
      }
    ]
  }
}

---

Provjeri izdavatelja

Provjerite izdavatelja kodom za provjeru poslanim na njegovu e-poštu.

POST /issuers/{issuerId}/verify

Parametri

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

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

{
  "statusCode": 200,
  "info": {
    "verified": true
  }
}

---

Obriši izdavatelja

Obrišite izdavatelja. Izdavatelj ne smije imati bedževa.

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

{
  "statusCode": 200,
  "info": {
    "deleted": true
  }
}

Pogreške

• 400 — izdavatelj ima bedževe ili dodjele i ne može se obrisati (prvo obrišite te)
• 404 — izdavatelj nije pronađen

---

Ažuriraj izdavatelja

Ažurirajte polja neprovjerenog izdavatelja. Nakon što je izdavatelj provjeren, samo logo i linkedinOrganizationId ostaju uredljivi radi očuvanja stabilnosti vjerodajnice.

PUT /issuers/{issuerId}

Parametri

Parametar	Tip	Obvezno	Opis
issuerId	string	Da	ID izdavatelja (parametar putanje)
name	string	Ne	Novi naziv (samo dok je neprovjeren)
url	string	Ne	Novi URL (samo dok je neprovjeren)
email	string	Ne	Nova e-pošta (samo dok je neprovjeren — šalje novu poruku za provjeru)
logo	string	Ne	Novi logo kodiran u Base64
linkedinOrganizationId	string	Ne	Novi LinkedIn organization ID (ili prazan niz za brisanje)

---

Rotiraj kod za provjeru

Poništite prethodnu poveznicu za provjeru i pošaljite novu e-poštom. Vrijedi samo dok je izdavatelj još neprovjeren.

POST /issuers/{issuerId}/rotate-code

Odgovor

{
  "statusCode": 200,
  "info": {
    "sent": true
  }
}