Быстрый старт

Создайте первый live-ключ и за пять минут сгенерируйте первую короткую ссылку через API.

1 мин чтения Разделов: 3

Beklio Link Developer API позволяет управлять ресурсами Link на реальных (live) данных. Все публичные запросы проходят через шлюз (gateway) по адресу https://api.beklio.com/api/v1/links.

1. Создайте ключ#

Войдите в консоль разработчика и создайте ключ bk_live_… только с теми scope, которые вам нужны. Секрет показывается только один раз — в ответе на создание; сразу сохраните его в менеджере секретов.

2. Отправьте первый запрос#

create-link.sh

curl -X POST "https://api.beklio.com/api/v1/links" \
  -H "Authorization: Bearer bk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-2026-001" \
  -d '{
    "kind": "DIRECT",
    "domainId": "bekl.io",
    "url": "https://example.com/launch",
    "slug": "launch"
  }'

Шлюз приводит ответы к конверту { data, meta? }, и каждый ответ содержит заголовок X-Request-Id.

3. Дальнейшие шаги#

Аутентификация и scope — какая операция требует какого разрешения.
Создание ссылок — разница между краткой формой и полным графом маршрутов.
Ошибки и лимиты — как ведут себя коды 401/403/409/429/503.

В новых интеграциях отправляйте уникальный Idempotency-Key с каждой мутацией; при сетевой ошибке можно безопасно повторить запрос с тем же ключом.

Чего-то не хватает или есть ошибка? Напишите в поддержку; приложив значение X-Request-Id из ответа, вы ускорите решение.