Удостоверяване

Всички 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/, които позволяват на всеки да верифицира удостоверенията за значки.