Skip to content

API кључеви

API кључеви вам омогућавају програмски приступ REST API-ју badges.ninja. Користите их за аутоматизацију креирања, додељивања и управљања значкама из сопствених апликација.

API кључеви — празно стање

Креирање API кључа

  1. Отворите страницу API Keys у бочном менију.
  2. Кликните Create API Key. Отвара се уграђени формулар:

Креирање кључа — форма за име

  1. Дајте кључу име и кликните Create. Пуни кључ се приказује једном на зеленом банеру:

Новокреирани кључ приказан једном

  1. Одмах копирајте кључ — приказује се само једном. Ако га изгубите, мораћете да направите нови. Након одбацивања банера, чува се само префикс:

Листа кључева са маскираним префиксом

Формат кључа

API кључеви користе префикс bws_ праћен хексадецималним низом од 32 карактера:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Коришћење API кључева у захтевима

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

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

Пуне детаље о API аутентификацији погледајте на страници Аутентификација.

Лимити кључева по плану

Број API кључева које можете да креирате зависи од плана:

ПланЛимит API кључева
Free1
Starter ($9/мес)5
Pro ($29/мес)20

Брисање кључа

  1. Отворите страницу API Keys.
  2. Пронађите кључ који желите да обришете.
  3. Кликните Delete.
  4. Потврдите брисање.

Потврда брисања кључа — опозив је тренутан

Након брисања кључ одмах престаје да ради. Све апликације које га користе добијаће грешке аутентификације.

badges.ninja Documentation