API клучеви

Создавајте, заменувајте и одземајте клучеви со кои вашите скрипти го повикуваат Bilify REST API, за продукција или за тест околината.

3 мин. читање Ажурирано 04.10.2026 Потребно: REST API и webhooks

Со API клуч вашиот софтвер (синхронизација со сметководство, онлајн продавница, скрипта) може да го повикува Bilify REST API. Тука ќе видите како се создава клуч, како се заменува без прекин во работата и како се исклучува.

Клучевите се во Поставки > Интеграции, во делот REST API. Сопственикот и администраторите можат да создаваат, заменуваат и одземаат клучеви. Другите улоги не ја гледаат страницата Интеграции.

Создавање клуч

Интерактивен преглед Создајте API клуч Чекор 1 од 7
Чекор 1: API клучеви ги прикажува активните клучеви, кога се создадени и кога последно се користени. Се гледа само почетокот на клучот. Чекор 2: Создај клуч го отвора формуларот за нов клуч. Чекор 3: Дајте му на клучот име по кое ќе го препознаете. Тоа е само ознака. Чекор 4: Продукциските клучеви стигнуваат до вистинските податоци. Тест клучевите се појавуваат тука штом ја овозможите тест околината. Чекор 5: Создај клуч го создава клучот. Тој дејствува како вас, со дозволите на вашата улога. Чекор 6: Копирајте го клучот сега и чувајте го безбедно. Се прикажува само овој еднаш. Чекор 7: Готово го затвора прозорецот. Новиот клуч сега е во листата.

API клучеви ги прикажува активните клучеви, кога се создадени и кога последно се користени. Се гледа само почетокот на клучот.

Создај клуч го отвора формуларот за нов клуч.

Дајте му на клучот име по кое ќе го препознаете. Тоа е само ознака.

Продукциските клучеви стигнуваат до вистинските податоци. Тест клучевите се појавуваат тука штом ја овозможите тест околината.

Создај клуч го создава клучот. Тој дејствува како вас, со дозволите на вашата улога.

Копирајте го клучот сега и чувајте го безбедно. Се прикажува само овој еднаш.

Готово го затвора прозорецот. Новиот клуч сега е во листата.

  1. Отворете Поставки > Интеграции и одете до REST API.
  2. Во картичката API клучеви кликнете Создај клуч.
  3. Внесете Име по кое ќе го препознаете клучот, на пример „Сметководствена синхронизација“. Името е само ознака за вас.
  4. Изберете Околина: Продукција работи со вашите вистински податоци, Тест околина со тест податоците. Опцијата Тест околина се појавува дури откако ќе ја овозможите тест околината (видете Тест околина).
  5. Кликнете Создај клуч.
  6. Копирајте го клучот од прозорецот Вашиот нов API клуч, зачувајте го во менаџер на лозинки или во тајните поставки на серверот, па кликнете Готово.

Клучот се прикажува само еднаш

Bilify чува само отпечаток од клучот. Штом го затворите прозорецот, никој, ниту поддршката на Bilify, не може повторно да го прикаже. Ако го изгубите, заменете го или одземете го и создадете нов.

Како изгледа клучот

Околина Префикс Пристапува до
Продукција blf_live_ Вашиот вистински работен простор
Тест околина blf_test_ Посебниот тест работен простор со тест податоци

Двата вида клучеви користат иста основна адреса. Префиксот одлучува до кој работен простор стигнува барањето. Во листата се гледа само почетокот на секој клуч, никогаш целата вредност, заедно со Создаден и Последно користен.

Што смее да прави клучот

Клучот дејствува како лицето што го создало, во овој работен простор, со дозволите на неговата улога. Ако клучот го создал администратор, клучот може да прави сè што администраторот може во апликацијата. Ако на тоа лице му се одземе пристапот до работниот простор, сите негови клучеви престануваат да работат уште при следното барање.

За REST API треба и пакетот да ја вклучува оваа можност и да имате активна претплата. Ако нешто од ова недостасува, барањата се одбиваат со порака што го објаснува тоа.

Клучевите сè уште немаат ограничувања (scopes)

Нема ограничувања на клучот ниту режим само за читање. Во базата постои поле за scopes, но ништо не го пополнува и ништо не го проверува. Ако сакате скриптата да може помалку, создадете го клучот од сметка чија улога дозволува само тие дејства. Во статијата за улоги пишува што може секоја улога.

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

Замена на клуч (планирана ротација)

Со замената добивате нов клуч без да ги прекинете скриптите што го користат стариот.

  1. Во редот на клучот отворете го менито (трите точки) и изберете Замени клуч.
  2. Потврдете. Се создава нов клуч со исто име и иста околина и се прикажува еднаш. Копирајте го.
  3. Ставете го новиот клуч во вашите скрипти.

Стариот клуч работи уште 24 часа. Означен е со Работи до и точното време, а потоа престанува да работи и исчезнува од листата.

Одземање клуч (протекол или повеќе не треба)

  1. Отворете го менито на клучот и изберете Одземи.
  2. Потврдете. Клучот веднаш престанува да работи и не може да се врати.

Протечен клуч? Одземете го, не заменувајте го

По замената стариот клуч работи уште 24 часа. Ако клучот можеби протекол (залепен во разговор, качен во репозиториум), одземете го, па создадете нов.

Тест клучеви

Тест клучевите (blf_test_) исто така се создаваат тука, во продукцискиот работен простор, на јазичето Тест околина во картичката API клучеви. Внатре во самата тест околина картичката прикажува само API клучевите се управуваат од продукција и копче Назад кон продукција.

Тест клуч може да чита и запишува само во тест околината. Никогаш не стигнува до вистинските податоци.

Решавање проблеми

Одговор Значење
401 invalid_api_key Клучот недостасува, погрешно е внесен, одземен е или му истекол рокот по замената. Пораката никогаш не кажува што точно.
403 workspace_membership_revoked Лицето што го создало клучот повеќе не е член на работниот простор.
403 plan_upgrade_required Вашиот пакет не го вклучува REST API.
403 no_active_plan Работниот простор нема активна претплата.
403 sandbox_not_provisioned Користен е blf_test_ клуч, а тест околината не е овозможена.