Для распрацоўшчыкаў

API B-LINK

Падключайце старонкі да CRM, табліц і аўтаматызацый: чытайце заяўкі і статыстыку, стварайце старонкі і блокі са свайго кода.

Навошта патрэбны API

Заяўкі з блокаў «Заяўка», «Запіс», «Квіз» і іншых адразу трапляюць у вашу CRM, Google-табліцу ці Telegram праз n8n, Make або Zapier.
Статыстыка праглядаў і клікаў — у вашых дашбордах і справаздачах.
Масавае стварэнне старонак і блокаў: агенцтвы і франшызы заводзяць дзясяткі старонак скрыптам, а не ўручную.

Як атрымаць ключ

Ключ выдаецца на тарыфе BUSINESS у раздзеле «Акаўнт → API». Ён дае поўны доступ да вашага акаўнта — не публікуйце яго і не ўстаўляйце ў код старонак. Калі ключ уцёк, там жа яго можна згенераваць нанова.

API даступны на тарыфе BUSINESS — Тарыфы

Як адпраўляць запыты

Усе адрасы пачынаюцца з базавага URL. Ключ перадаецца ў загалоўку Authorization як Bearer-токен. Адказы — у JSON; ліміт — 60 запытаў за хвіліну (пры перавышэнні прыйдзе код 429). Спісы аддаюцца пастаронкава: параметры page і results_per_page, у адказе ёсць meta з агульнай колькасцю.

Базавы URL		`https://b-link.cc/api`
Authorization	header	`Bearer {api_key}`
Content-Type	header	`application/json` или `application/x-www-form-urlencoded`

Прыклад

curl "https://b-link.cc/api/user" \
  -H "Authorization: Bearer {api_key}"

Памылкі

Пры памылцы прыходзіць HTTP-код і JSON выгляду {"error": {"message": "…"}}: 401 — няма ці няправільны ключ, або API не ўваходзіць у тарыф; 404 — аб’ект не знойдзены ці не ваш; 429 — перавышаны ліміт; 400 — няправільныя параметры.

Рэсурсы

Карыстальнік

Даныя вашага акаўнта і тарыфу.

https://b-link.cc/api/user

Старонкі

Спіс вашых мультыспасылак, стварэнне і змена адраса, статусу, налад.

https://b-link.cc/api/links

Блокі старонкі

Блокі канкрэтнай мультыспасылкі: спіс, даданне блока патрэбнага тыпу з наладамі, змена і выдаленне.

https://b-link.cc/api/biolinks-blocks

Заяўкі

Усё, што пакінулі наведвальнікі ў формах, запісах, квізах і апытаннях — тое ж, што ў раздзеле «Заяўкі».

https://b-link.cc/api/data

Статыстыка

Прагляды і клікі старонкі па днях, краінах, прыладах і крыніцах.

https://b-link.cc/api/statistics

QR-коды

Вашы QR-коды: спіс, стварэнне, змена, выдаленне.

https://b-link.cc/api/qr-codes

Пікселі

Пікселі Meta, TikTok, Google і іншыя, якія вы падключаеце да старонак.

https://b-link.cc/api/pixels

Дамены

Вашы падключаныя дамены.

https://b-link.cc/api/domains

Плацяжы

Гісторыя вашых аплат тарыфу.

https://b-link.cc/api/payments

Журнал уваходаў

Уваходы ў акаўнт: дата, прылада, горад.

https://b-link.cc/api/users-logs

Блокі старонкі — Прыклад

Тып блока — ключ з каталога (hero, link, socials, contacts, catalog, booking, faq …). Поле settings прымае тыя ж ключы, што і форма блока ў рэдактары; невядомыя палі адкідаюцца, выявы праз API не загружаюцца.

GET https://b-link.cc/api/biolinks-blocks?link_id={link_id}

POST https://b-link.cc/api/biolinks-blocks

curl -X POST "https://b-link.cc/api/biolinks-blocks" \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{"link_id": {link_id}, "type": "link", "settings": {"name": "Записаться", "icon": "fa fa-calendar-check"}, "location_url": "https://t.me/yourname"}'

POST https://b-link.cc/api/biolinks-blocks/{id}

DELETE https://b-link.cc/api/biolinks-blocks/{id}

Заяўкі — Прыклад

curl "https://b-link.cc/api/data?link_id={link_id}&results_per_page=50" \
  -H "Authorization: Bearer {api_key}"

Падключэнне без кода

У n8n, Make ці Zapier дадайце крок «HTTP Request»: метад GET, адрас заявак (гл. «Заяўкі»), загаловак Authorization: Bearer ВАШ_КЛЮЧ. Запускайце яго па раскладзе раз на 5–10 хвілін і перадавайце новыя запісы далей — у CRM, табліцу ці мэсэнджар. Гатовыя апавяшчэнні пра заяўкі ў Telegram і на пошту ўжо ёсць у раздзеле «Акаўнт → Апавяшчэнні» без усякага кода.