Jak działa API

Program potrzebuje klucza, zanim skróci link. Zrób klucz na tej stronie, skopiuj go i wklej do programu. Są też darmowe szablony n8n i GitHub. UTM, QR, MCP i n8n są w każdym planie; przepisy Slack i GitHub dla zespołów — w Business. Ta strona nie trzyma twojego klucza.

Jak używać

1. Zrób klucz

Klucz to hasło dla programu. Robisz go na tej stronie. Czat nie zrobi go za ciebie.

Zarejestruj się albo zaloguj.
Otwórz API Keys. Jeśli strona prosi o logowanie, zaloguj się i otwórz API Keys jeszcze raz.
Kliknij Create New Key.
Skopiuj klucz. Zaczyna się od slk_. Cały klucz widać tylko raz. Jeśli go zgubisz, zrób nowy.

Otwórz API Keys

2. Włóż klucz do każdego żądania

Każde żądanie potrzebuje twojego klucza. Wyślij go w nagłówku x-api-key albo napisz Authorization: Bearer i potem klucz.

W przykładach YOUR_API_KEY to puste miejsce. W swojej komendzie zamień te słowa na skopiowany klucz slk_. Nie wysyłaj słów YOUR_API_KEY.

x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

Przykłady

▸Skróć jeden link

Robi jeden krótki link. slug jest opcjonalny. To krótka nazwa: litery, cyfry i myślniki.

curl -X POST https://linkbit.live/api/v1/links \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"destination": "https://example.com/long-url", "slug": "my-link", "utm_source": "newsletter"}'

▸Skróć wiele linków (do 100 w twoim planie)

Robi wiele linków w jednym żądaniu. Złe wiersze wracają w errors. Dobre wiersze i tak powstają.

curl -X POST https://linkbit.live/api/v1/links/bulk \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"urls": [
    {"destination": "https://example.com/page1"},
    {"destination": "https://example.com/page2", "slug": "my-custom-slug"}
  ]}'

▸Lista twoich linków

Pokazuje każdy krótki link tego klucza, od najnowszego, z krótkim adresem i liczbą kliknięć.

curl https://linkbit.live/api/v1/links \
  -H "x-api-key: YOUR_API_KEY"

▸Kliknięcia jednego linku

Użyj id z tworzenia albo z listy. Dostajesz kliknięcia, odwiedzających, kraje, urządzenia, źródła i sumy dzienne.

curl "https://linkbit.live/api/v1/links/LINK_ID/stats?from=2026-01-01&to=2026-01-31" \
  -H "x-api-key: YOUR_API_KEY"

▸Kliknięcia całego konta

Najważniejsze linki, liczby dzienne, kraje, urządzenia i źródła.

curl https://linkbit.live/api/v1/analytics \
  -H "x-api-key: YOUR_API_KEY"

n8n, Slack i GitHub

Pobierz szablon, wstaw klucz slk_ w nagłówku x-api-key i uruchom. To to samo REST API co w przykładach wyżej. Kreator UTM, QR, MCP i szablony n8n są w każdym planie. Przepisy Slack i GitHub dla zespołów są w Business na Pricing.

n8n — skróć jeden URL — Zaimportuj do n8n, zamień slk_YOUR_API_KEY, potem Test workflow
n8n — skracanie Slack / webhook — Webhook przyjmuje JSON z destination i zwraca shortUrl
GitHub Action — skróć URL wydania — Skopiuj do .github/workflows i ustaw sekret LINKBIT_API_KEY

Zobacz, w którym planie są UTM, QR, MCP, n8n i Slack

Co znaczy każde pole

Pole	Gdzie	Uwagi
destination	create / bulk	Wymagane. Zwykły publiczny adres, który zaczyna się od http:// albo https://. Localhost i adresy prywatne są odrzucane. To pole możesz też nazwać url.
slug	create / bulk	Opcjonalne. Krótka nazwa po domenie. Litery, cyfry i myślniki. Spacje stają się myślnikami.
utm_source … utm_content	create / bulk / CSV	Opcjonalne. Znaczniki kampanii dopisywane do długiego adresu. Znaczniki, które już tam są, zostają. Część po # też zostaje.
urls	bulk body	Lista linków. To pole możesz też nazwać links.
created / errors	bulk response	Linki, które się udały, i notatka przy każdym, który się nie udał.

401 znaczy, że klucza brak albo jest zły. 400 znaczy, że adres jest zły albo zrobiłeś dziś za dużo linków. 404 znaczy, że tego id linku nie ma.