Аутентификација

Сви API захтеви ка badges.ninja захтевају аутентификацију. Ова страница објашњава како да аутентификујете своје захтеве.

Основни URL

https://api.badges.ninja

Све API крајње тачке су релативне у односу на овај основни URL.

Аутентификација API кључем

Примарни метод аутентификације је API кључ који се прослеђује у заглављу X-Api-Key.

Добијање API кључа

Са контролне табле:

1. Пријавите се на badges.ninja.
2. Идите на API Keys у бочној траци.
3. Кликните на Create API Key.
4. Копирајте кључ (приказује се само једном).

Преко API-ја:

API кључевима се може управљати и преко API-ја помоћу вашег JWT токена из Cognito тока аутентификације. Најједноставнији приступ је контролна табла.

Коришћење API кључа

Укључите заглавље X-Api-Key у сваки захтев:

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

Формат API кључа

Кључеви имају префикс bws_:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Формат захтева

• GET захтеви прослеђују параметре као query стрингове
• POST и PUT захтеви шаљу JSON тело са објектом parameters
• Сви одговори враћају JSON са Content-Type: application/json

Структура POST/PUT захтева

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

Пример захтева

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

Пример одговора

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

Јавне крајње тачке

Неке крајње тачке не захтевају аутентификацију. То су јавне крајње тачке за верификацију под /certify-badge/ које омогућавају свима да верификују акредитиве значки.