Udsteder-API

Administrér mærkeudstedere — organisationerne eller personerne, der uddeler mærker.

Alle endpoints kræver godkendelse via X-Api-Key-headeren. Se Godkendelse.

Opret udsteder

Opret en ny mærkeudsteder.

POST /issuers

Parametre

Parameter	Type	Påkrævet	Beskrivelse
name	string	Ja	Organisationsnavn (mindst 3 tegn)
url	string	Ja	Organisationens hjemmeside (skal være en gyldig HTTP/HTTPS-URL)
email	string	Ja	Kontakt-e-mail for udstederen
logo	string	Nej	Base64-kodet billede (PNG eller JPG)
linkedinOrganizationId	string	Nej	Numerisk LinkedIn-virksomhedssideid. Når sat, viser hver offentlig udmærkelsesside fra denne udsteder en knap Add to LinkedIn Profile.

Eksempel

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

Svar

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

Bemærkninger

• Tæller mod din plans udstedergrænse (Free: 1, Starter: 5, Pro: ubegrænset). Intet kvotafradrag.
• Hvis udstederens e-mail matcher din kontos e-mail, autoverificeres udstederen.
• Hvis e-mailen er anderledes, sendes en verificerings-e-mail til udstederens e-mail.

---

Liste udstedere

Hent alle udstedere, du har oprettet.

GET /issuers

Eksempel

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

Svar

{
  "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ér udsteder

Verificér en udsteder ved hjælp af verificeringskoden sendt til dens e-mail.

POST /issuers/{issuerId}/verify

Parametre

Parameter	Type	Påkrævet	Beskrivelse
issuerId	string	Ja	Udsteder-ID (stiparameter)
code	string	Ja	Verificeringskoden fra e-mailen

Eksempel

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

Svar

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

---

Slet udsteder

Slet en udsteder. Udstederen må ikke have nogen mærker.

DELETE /issuers/{issuerId}

Eksempel

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

Svar

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

Fejl

• 400 — udstederen har mærker eller udmærkelser og kan ikke slettes (slet disse først)
• 404 — udstederen blev ikke fundet

---

Opdatér udsteder

Opdatér felter på en uverificeret udsteder. Når en udsteder er verificeret, forbliver kun logo og linkedinOrganizationId redigerbare for at bevare bevisstabiliteten.

PUT /issuers/{issuerId}

Parametre

Parameter	Type	Påkrævet	Beskrivelse
issuerId	string	Ja	Udsteder-ID (stiparameter)
name	string	Nej	Nyt navn (kun når uverificeret)
url	string	Nej	Ny URL (kun når uverificeret)
email	string	Nej	Ny e-mail (kun når uverificeret — sender en ny verificeringsmail)
logo	string	Nej	Nyt base64-kodet logo
linkedinOrganizationId	string	Nej	Nyt LinkedIn-organisations-ID (eller tom streng for at rydde)

---

Rotér verificeringskode

Ugyldiggør det forrige verificeringslink, og send et nyt via e-mail. Kun gyldigt, mens udstederen stadig er uverificeret.

POST /issuers/{issuerId}/rotate-code

Svar

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