API

Creá enlaces y leé la estadística desde tu código. La API está disponible en el plan Business. Dirección base — https://funnellink.cc/api/v1.

Autorización

Sacá una clave en la sección API y mandala en el encabezado. Límite — 120 peticiones por minuto.

Authorization: Bearer fll_key

Crear un enlace

POST /links. Lo mínimo es el campo url. Se puede definir slug, title, campaign, domain.

curl -X POST https://funnellink.cc/api/v1/links \
  -H "Authorization: Bearer fll_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/landing", "title": "Promo", "campaign": "Verano"}'

Respuesta:

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

Test A/B — pasá el arreglo variants (hasta 5):

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

Lista de enlaces

GET /links

curl https://funnellink.cc/api/v1/links -H "Authorization: Bearer fll_key"

Estadística de un enlace

GET /links/{slug}/stats — clics, conversiones y desglose por variante y por acción objetivo.

curl https://funnellink.cc/api/v1/links/aB3xYz/stats -H "Authorization: Bearer fll_key"

{
  "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": "Pedido", "conversions": 12}]
}

Errores

401 — falta la clave o es inválida, 403 — el plan no es Business, 422 — datos incorrectos, 429 — se superó el límite de peticiones. El cuerpo del error es { "error": "..." }.