Godkendelse

Alle API-forespørgsler til badges.ninja kræver godkendelse. Denne side forklarer, hvordan du godkender dine forespørgsler.

Basis-URL

https://api.badges.ninja

Alle API-endpoints er relative til denne basis-URL.

API-nøglegodkendelse

Den primære godkendelsesmetode er en API-nøgle, der sendes i X-Api-Key-headeren.

Hent en API-nøgle

Fra dashboardet:

1. Log ind på badges.ninja.
2. Gå til API-nøgler i sidebjælken.
3. Klik på Opret API-nøgle.
4. Kopiér nøglen (den vises kun én gang).

Fra API'et:

API-nøgler kan også administreres via API'et ved hjælp af dit JWT-token fra Cognito-godkendelsesflowet. Se dashboardet for den nemmeste tilgang.

Brug din API-nøgle

Medtag X-Api-Key-headeren i hver forespørgsel:

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

API-nøgleformat

Nøgler bruger præfikset bws_:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Forespørgselsformat

• GET-forespørgsler sender parametre som forespørgselsstrenge
• POST- og PUT-forespørgsler sender en JSON-body med et parameters-objekt
• Alle svar returnerer JSON med Content-Type: application/json

Struktur for POST/PUT-forespørgsel

{
  "parameters": {
    "name": "My Badge",
    "description": "A sample badge"
  }
}

Eksempel-forespørgsel

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": "My Organization",
      "url": "https://example.com",
      "email": "admin@example.com"
    }
  }'

Eksempelsvar

{
  "statusCode": 200,
  "info": {
    "issuerId": "https://api.badges.ninja/certify-badge/issuer/abc123-def456"
  }
}

Hastighedsgrænser

API-forespørgsler er underlagt hastighedsbegrænsning. Hvis du overskrider grænsen, modtager du et 429 Too Many Requests-svar. Vent nogle sekunder, og prøv igen.

Offentlige endpoints

Nogle endpoints kræver ikke godkendelse. Det er de offentlige verificerings-endpoints under /certify-badge/, der lader alle verificere mærkebeviser.