Documentacion del espacio de trabajo

Docs del espacio de trabajo Lynko

Aprende como las opciones del espacio de trabajo Lynko, el acceso API developer, los webhooks y las analíticas encajan para crear links, códigos QR y flujos de campaña con confianza.

Abrir espacio de trabajo Developer Descargar especificacion OpenAPI

Vista general del espacio de trabajo

Un espacio de trabajo para cada punto de contacto público

Un espacio de trabajo Lynko mantiene tus links públicos, códigos QR, páginas, campañas e informes en un solo lugar. Cada herramienta puede funcionar sola, pero los flujos más fuertes las combinan.

Enlaces cortos

Crea links limpios y compartibles con tracking opcional, reglas de caducidad, passwords, Smart Redirects y estadísticas públicas.

Códigos QR dinámicos

Crea códigos QR que mantienen el mismo código impreso aunque el destino cambie después.

Páginas de links

Pública páginas link-in-bio para perfiles sociales, campañas, eventos y destinos importantes.

Kits de campaña

Agrupa enlaces cortos, códigos QR, landing pages, polls, bloques Reward Unlock e informes alrededor de una promoción.

Smart Cards

Prepara tarjetas imprimibles o digitales con destinos QR que puedes actualizar desde el espacio de trabajo.

Polls y páginas AMA

Recoge votos o preguntas de tu audiencia y revisa la actividad desde la misma cuenta.

Action Hubs

Comparte links de donación, tienda, contacto y comunidad desde una página pública de soporte.

Counters e Insight Pixels

Mide visitas con counters ligeros y analíticas de espacio de trabajo respetuosas con la privacidad.

Workspace options

Que puedes gestionar desde el panel

Las opciones del espacio de trabajo cubren creacion de contenido, analíticas, imports, exports, acceso developer y controles orientados a privacidad. Los límites del plan aplican a assets activos o con tracking, mientras que los enlaces cortos sin tracking siguen siendo ilimitados.

Gestion de assets

Crea, edita, pausa, restaura y organiza tus assets públicos de Lynko desde el panel.

Analíticas

Revisa clics, escaneos, vistas, votos, referrers, dispositivos, idiomas y resultados de campaña donde el tracking está activado.

Límites dependientes del plan

Los enlaces cortos con tracking, páginas publicadas, códigos QR activos, Smart Cards, polls, counters, pixels, botones de Action Hub y Campaign Kits siguen los límites del plan.

Imports y exports

Mueve datos del espacio de trabajo hacia dentro y fuera con herramientas CSV y export compatibles cuando tu plan lo permite.

Developer access

Crea claves API con permisos, conecta webhooks y automatiza acciones compatibles del espacio de trabajo.

Controles de privacidad

Usa analíticas respetuosas con la privacidad, URLs raiz de Lynko, uploads seguros y comprobaciónes de propiedad en las herramientas del espacio de trabajo.

API developer

Inicio rápido de API

La API de Lynko es una API JSON de plataforma completa para automatizacion del espacio de trabajo. Crea una clave API en el espacio de trabajo Developer, elige solo los permisos que necesita tu integración y envía requests a la URL base de la API.

URL base /api/v1
Autenticación X-API-Key or Authorization: Bearer API_KEY
Formato de respuesta Raw JSON
OpenAPI /openapi.json

Autenticación

Usa X-API-Key para la autenticación de API más confiable. Los tokens Authorization Bearer también son compatibles cuando tu hosting pasa los headers Authorization a PHP.

Una respuesta 401 significa que la clave no fue aceptada. Revisa que la clave este activa, no revocada, copiada sin espacios y que pertenezca al host de API que estas llamando.

Rate limits de API por plan
Plan Requests por minuto Requests por dia
Free / Bronze 20 1000
Silver 60 5000
Gold 120 20000

Las lecturas usan límites normales. Escrituras y resumenes de analíticas usan límites más estrictos, mientras exports, pruebas de webhook y uploads pequeños usan los límites más estrictos.

Ejemplos de uso

Usa la API de varias formas

Estos ejemplos muestran patrones comunes. Sustituye YOUR_API_KEY por una clave con permisos del espacio de trabajo Developer y mantenla privada.

El ejemplo de JavaScript debe ejecutarse en la consola del navegador o en Node.js, no directamente en Windows PowerShell. Para PowerShell, usa el ejemplo de Windows PowerShell.

Comprobar tu clave API

curl -H "X-API-Key: YOUR_API_KEY" https://lynko.tv/api/v1/me

Crear un short link con cURL

curl -X POST https://lynko.tv/api/v1/shortlinks \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/landing","title":"Campaign launch"}'

Crear un código QR con JavaScript

const response = await fetch('https://lynko.tv/api/v1/qr-codes', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    target_url: 'https://example.com/menu',
    title: 'Menu QR code'
  })
});

const qrCode = await response.json();

Crear un código QR con Windows PowerShell

$headers = @{
  'X-API-Key' = 'YOUR_API_KEY'
}

$body = @{
  target_url = 'https://example.com/menu'
  title = 'Menu QR code'
} | ConvertTo-Json

$response = Invoke-RestMethod `
  -Uri 'https://lynko.tv/api/v1/qr-codes' `
  -Method Post `
  -Headers $headers `
  -ContentType 'application/json' `
  -Body $body

$response

Leer analíticas con PHP

<?php
$ch = curl_init('https://lynko.tv/api/v1/analytics/summary');
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
  CURLOPT_RETURNTRANSFER => true,
]);
$json = curl_exec($ch);
curl_close($ch);
$summary = json_decode((string)$json, true);

Automatizar configuración de campaña

Crea un short link, crea un código QR para el mismo destino y revisa el rendimiento desde analíticas.

Sincronizar destinos públicos

Actualiza páginas de links, Smart Cards, Action Hubs o destinos QR desde tus herramientas internas.

Crear paneles de informes

Obtiene resumenes de analíticas del espacio de trabajo y combinalos con tus notas de campaña o informes de clientes.

Recibir eventos con webhooks

Usa webhooks para clics de links, escaneos QR, envios de capture, leads de campaña, votos de polls y cambios de billing.

Permisos y endpoints

Elige el conjunto minimo de permisos útil

Las claves API tienen alcance. Da a cada integración solo los permisos que necesita y rota o revoca claves desde el espacio de trabajo Developer cuando el acceso ya no sea necesario.

Cuenta

  • account:readLeer email de cuenta y detalles de suscripción

Activos principales

  • links:readLeer shortlinks
  • links:writeCrear y actualizar shortlinks
  • qr:readLeer códigos QR
  • qr:writeCrear y actualizar códigos QR
  • trees:readLeer páginas de links
  • trees:writeCrear y actualizar páginas de links

Engagement

  • polls:readLeer encuestas
  • polls:writeCrear y actualizar encuestas
  • ama:readLeer páginas AMA
  • ama:writeGestionar páginas AMA
  • capture:readLeer datos de Reward Unlock
  • capture:writeGestionar bloques Reward Unlock

Herramientas del espacio de trabajo

  • campaigns:readLeer Campaign Kits
  • campaigns:writeCrear y actualizar Campaign Kits
  • cards:readLeer Smart Cards
  • cards:writeCrear y actualizar Smart Cards
  • counters:readLeer contadores e Insight Pixels
  • counters:writeCrear y actualizar contadores e Insight Pixels
  • support:readLeer Action Hub
  • support:writeGestionar Action Hub
  • drops:readLeer Creator Drops
  • drops:writeCrear y actualizar Creator Drops

Integraciones

  • analytics:readLeer resumenes de analíticas
  • webhooks:writeGestionar webhooks
  • uploads:writeSubir media API pequena

Cuenta

GET /api/v1/me Detalles de cuenta y clave API account:read for email and subscription details
GET /api/v1/rate-limits Límites del plan actual y costes de endpoints -

Activos principales

GET /api/v1/shortlinks Listar shortlinks links:read
POST /api/v1/shortlinks Crear un enlace corto links:write
GET /api/v1/qr-codes Listar códigos QR qr:read
POST /api/v1/qr-codes Crear un código QR qr:write
GET /api/v1/link-pages Listar páginas de links trees:read
POST /api/v1/link-pages Crear página de links trees:write

Engagement

GET /api/v1/polls Listar encuestas polls:read
POST /api/v1/polls Crear una encuesta polls:write
GET /api/v1/ama Leer ajustes AMA ama:read
POST /api/v1/ama Crear o actualizar ajustes AMA ama:write
GET /api/v1/capture/blocks Listar bloques Reward Unlock capture:read
POST /api/v1/capture/blocks Crear o actualizar bloque Reward Unlock capture:write
GET /api/v1/capture/submissions Listar envios Reward Unlock capture:read

Herramientas del espacio de trabajo

GET /api/v1/campaign-kits Listar Campaign Kits campaigns:read
POST /api/v1/campaign-kits Crear un Campaign Kit campaigns:write
GET /api/v1/smart-cards Listar Smart Cards cards:read
POST /api/v1/smart-cards Crear Smart Card cards:write
GET /api/v1/counters Listar contadores e Insight Pixels counters:read
POST /api/v1/counters Crear contador o Insight Pixel counters:write
GET /api/v1/support-hub Leer ajustes de Action Hub support:read
PUT /api/v1/support-hub Actualizar ajustes de Action Hub support:write
GET /api/v1/creator-drops Listar Creator Drops drops:read
POST /api/v1/creator-drops Crear Creator Drop drops:write
POST /api/v1/creator-drops/{id}/images Subir una imagen Creator Drop drops:write + uploads:write

Integraciones

GET /api/v1/analytics/summary Leer resumen de analíticas del espacio de trabajo analytics:read
GET /api/v1/webhooks Listar endpoints webhook webhooks:write
POST /api/v1/webhooks Crear endpoint webhook webhooks:write
PATCH /api/v1/webhooks/{id} Actualizar endpoint webhook webhooks:write
DELETE /api/v1/webhooks/{id} Eliminar endpoint webhook webhooks:write
POST /api/v1/webhooks/{id}/test Poner en cola un evento de prueba webhook webhooks:write

Siguientes pasos

Links útiles del espacio de trabajo

Usa estas páginas cuando quieras crear claves API, conectar webhooks, exportar datos o pedir ayuda de integración.

Abrir espacio de trabajo Developer Crea claves API, revisa límites y gestiona acceso developer. Descargar especificacion OpenAPI Usa la descripción API legible por maquinas en herramientas developer. Gestionar webhooks Conecta entrega de eventos para acciones compatibles del espacio de trabajo. Importar y exportar datos Mueve datos del espacio de trabajo con herramientas compatibles del panel. Contactar soporte Pide ayuda con configuración del espacio de trabajo, acceso API o preguntas de integración.