API-ul emitenților

Gestionează emitenții credențialelor — organizațiile sau persoanele care acordă credențiale.

Toate endpoint-urile necesită autentificare prin antetul X-Api-Key. Consultă Autentificare.

Creează emitent

Creează un emitent nou.

POST /issuers

Parametri

Parametru	Tip	Obligatoriu	Descriere
name	string	Da	Denumirea organizației (minimum 3 caractere)
url	string	Da	Site-ul web al organizației (URL HTTP/HTTPS valid)
email	string	Da	E-mail de contact al emitentului
logo	string	Nu	Imagine codificată în Base64 (PNG sau JPG)
linkedinOrganizationId	string	Nu	ID numeric al paginii de companie LinkedIn. Dacă este setat, fiecare pagină publică de acordare a acestui emitent afișează un buton Add to LinkedIn Profile.

Exemplu

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

Răspuns

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

Note

• Se contabilizează în limita de emitenți a planului (Free: 1, Starter: 5, Pro: nelimitat). Fără scădere din alocație.
• Dacă e-mailul emitentului coincide cu e-mailul contului, este verificat automat.
• Dacă e-mailul diferă, se trimite un e-mail de verificare la adresa emitentului.

---

Listează emitenții

Recuperează toți emitenții pe care i-ai creat.

GET /issuers

Exemplu

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

Răspuns

{
  "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"
      }
    ]
  }
}

---

Verifică emitent

Verifică un emitent cu ajutorul codului de verificare trimis la adresa sa de e-mail.

POST /issuers/{issuerId}/verify

Parametri

Parametru	Tip	Obligatoriu	Descriere
issuerId	string	Da	ID-ul emitentului (parametru de rută)
code	string	Da	Codul de verificare primit pe e-mail

Exemplu

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

Răspuns

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

---

Șterge emitent

Șterge un emitent. Emitentul nu trebuie să aibă credențiale.

DELETE /issuers/{issuerId}

Exemplu

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

Răspuns

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

Erori

• 400 — emitentul are credențiale sau acordări și nu poate fi șters (șterge-le mai întâi)
• 404 — emitent negăsit

---

Actualizează emitent

Actualizează câmpurile unui emitent neverificat. După verificare, doar logo și linkedinOrganizationId rămân editabile, pentru a păstra stabilitatea credențialelor.

PUT /issuers/{issuerId}

Parametri

Parametru	Tip	Obligatoriu	Descriere
issuerId	string	Da	ID-ul emitentului (parametru de rută)
name	string	Nu	Nume nou (doar dacă nu este verificat)
url	string	Nu	URL nou (doar dacă nu este verificat)
email	string	Nu	E-mail nou (doar dacă nu este verificat — trimite un nou e-mail de verificare)
logo	string	Nu	Logo nou codificat în Base64
linkedinOrganizationId	string	Nu	Nou LinkedIn organization ID (sau șir gol pentru a-l elimina)

---

Rotește codul de verificare

Invalidează linkul de verificare anterior și trimite unul nou prin e-mail. Valabil doar cât timp emitentul rămâne neverificat.

POST /issuers/{issuerId}/rotate-code

Răspuns

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