API кључеви

Страница API кључеви омогућава креирање приступних кључева за интеграције које користе Бади API.

Ова страница је доступна ако имате дозволу за преглед API кључева. За додавање, измену и брисање потребне су одговарајуће дозволе за API кључеве.

API документацију можете пронаћи на следећој адреси: https://badi.rs/api-docs

Преглед кључева

У табели се приказују:

• API кључ
• време последње употребе

Ако кључ није коришћен, у колони Последња употреба биће приказана цртица.

Додавање API кључа

Додавање API кључа се врши кликом на дугме Додај API кључ. Након тога се отвара панел за додавање кључа.

У панелу се приказују:

• API кључ
• API тајна
• ИД клијента

API кључ се генерише аутоматски и није га потребно ручно уносити. Кључ садржи ознаку окружења, на пример sandbox или production, како би било јасно за које окружење је направљен.

API тајна се приказује само приликом креирања кључа. Сачувајте је на безбедном месту, јер је након затварања панела више нећете моћи видети.

ИД клијента је вредност која се користи код API ресурса који захтевају референцирање конкретне инсталације.

Пажња

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

Тренутно није могуће ограничити кључ на појединачне модуле, радње, продајна места или друге опсеге приступа.

За сваку интеграцију користите посебан кључ, како бисте га могли лако обрисати или заменити ако интеграција више није у употреби.

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

API кључ и API тајна користе се као приступни подаци интеграције. Интеграцију подесите тако да кључ и тајну чува безбедно и да их не излаже у јавном коду, URL адресама или логовима.

Приступ се врши преко HTTP Basic аутентификације, где се као корисничко име шаље API кључ, а као лозинка API тајна.

За неке API позиве може бити потребно да се пошаље и додатни технички контекст, као што је ИД клијента или идентификатор корисника, у складу са API документацијом. Ово не ограничава опсег приступа самог кључа.

Измена API кључа

Измена API кључа се врши кликом на ред у табели или иконицу за измену. У панелу за измену можете регенерисати API тајну.

Ако регенеришете тајну, стара тајна више неће бити употребљива. Обавезно ажурирајте све интеграције које користе тај кључ.

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

Брисање API кључа се врши кликом на иконицу код сваког кључа. Након тога се приказује потврда брисања.

Када кључ обришете, интеграције које га користе више неће моћи да приступе Бади API-ју. Брисање користите када интеграција више није у употреби или ако сумњате да је кључ компромитован.