Для разработчиков

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 с общим количеством.

Базовый URLhttps://b-link.cc/api
AuthorizationheaderBearer {api_key}
Content-Typeheaderapplication/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 — неверные параметры (в message сказано какие).

Ресурсы

Пользователь

Данные вашего аккаунта и тарифа.

Страницы

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

Блоки страницы

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

Заявки

Всё, что оставили посетители в формах, записях, квизах и опросах — то же, что в разделе «Заявки».

Статистика

Просмотры и клики страницы по дням, странам, устройствам и источникам.

QR-коды

Ваши QR-коды: список, создание, изменение, удаление.

Пиксели

Пиксели Meta, TikTok, Google и другие, которые вы подключаете к страницам.

Домены

Ваши подключённые домены.

Платежи

История ваших оплат тарифа.

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

Входы в аккаунт: дата, устройство, город.

Блоки страницы — Пример

Тип блока — ключ из каталога (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 и на почту уже есть в разделе «Аккаунт → Уведомления» без всякого кода.