API

Создавайте ссылки и читайте статистику программно. API доступен на тарифе Бизнес. Базовый адрес — https://funnellink.cc/api/v1.

Авторизация

Получите ключ в разделе API и передавайте его в заголовке. Лимит — 120 запросов в минуту.

Authorization: Bearer fll_ваш_ключ

Создать ссылку

POST /links. Минимум — поле url. Можно задать slug, title, campaign, domain.

curl -X POST https://funnellink.cc/api/v1/links \
  -H "Authorization: Bearer fll_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/landing", "title": "Промо", "campaign": "Весна"}'

Ответ:

{ "slug": "aB3xYz", "short_url": "https://funlnk.cc/aB3xYz" }

A/B-тест — передайте массив variants (до 5):

{"variants": [
  {"url": "https://example.com/a", "weight": 50},
  {"url": "https://example.com/b", "weight": 50}
]}

Список ссылок

GET /links

curl https://funnellink.cc/api/v1/links -H "Authorization: Bearer fll_ваш_ключ"

Статистика по ссылке

GET /links/{slug}/stats — клики, конверсии, разбивка по вариантам и целевым действиям.

curl https://funnellink.cc/api/v1/links/aB3xYz/stats -H "Authorization: Bearer fll_ваш_ключ"

{
  "slug": "aB3xYz",
  "clicks": 128,
  "conversions": 17,
  "conversion_rate": 13.28,
  "variants": [
    {"id": "a", "url": "...", "clicks": 64, "conversions": 5, "conversion_rate": 7.81}
  ],
  "goals": [{"code": "aB3xYz_g1", "label": "Заявка", "conversions": 12}]
}

Ошибки

401 — нет/неверный ключ, 403 — тариф не Бизнес, 422 — некорректные данные, 429 — превышен лимит запросов. Тело ошибки — { "error": "..." }.