Documentacion del workspace

Docs del workspace Lynko

Aprende como las opciones del workspace Lynko, el acceso API developer, los webhooks y las analytics encajan para crear links, codigos QR y flujos de campana con confianza.

Abrir workspace Developer Descargar especificacion OpenAPI

Vista general del espacio de trabajo

Un workspace para cada punto de contacto publico

Un workspace Lynko mantiene tus links publicos, codigos QR, paginas, campanas e informes en un solo lugar. Cada herramienta puede funcionar sola, pero los flujos mas fuertes las combinan.

Short links

Crea links limpios y compartibles con tracking opcional, reglas de caducidad, passwords, Smart Redirects y estadisticas publicas.

Codigos QR dinamicos

Crea codigos QR que mantienen el mismo codigo impreso aunque el destino cambie despues.

Paginas de links

Publica paginas link-in-bio para perfiles sociales, campanas, eventos y destinos importantes.

Kits de campana

Agrupa short links, codigos QR, landing pages, polls, bloques Reward Unlock e informes alrededor de una promocion.

Smart Cards

Prepara tarjetas imprimibles o digitales con destinos QR que puedes actualizar desde el workspace.

Polls y paginas AMA

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

Support Hubs

Comparte links de donacion, tienda, contacto y comunidad desde una pagina publica de soporte.

Counters e Insight Pixels

Mide visitas con counters ligeros y analytics de workspace respetuosas con la privacidad.

Workspace options

Que puedes gestionar desde el dashboard

Las opciones del workspace cubren creacion de contenido, analytics, imports, exports, acceso developer y controles orientados a privacidad. Los limites del plan aplican a assets activos o con tracking, mientras que los short links sin tracking siguen siendo ilimitados.

Gestion de assets

Crea, edita, pausa, restaura y organiza tus assets publicos de Lynko desde el dashboard.

Analytics

Revisa clics, escaneos, vistas, votos, referrers, dispositivos, idiomas y resultados de campana donde el tracking esta activado.

Limites dependientes del plan

Los short links con tracking, paginas publicadas, codigos QR activos, Smart Cards, polls, counters, pixels, botones de Support Hub y Campaign Kits siguen los limites del plan.

Imports y exports

Mueve datos del workspace 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 workspace.

Controles de privacidad

Usa analytics respetuosas con la privacidad, URLs raiz de Lynko, uploads seguros y comprobaciones de propiedad en las herramientas del workspace.

API developer

Inicio rapido de API

La API de Lynko es una API JSON de plataforma completa para automatizacion del workspace. Crea una clave API en el workspace Developer, elige solo los permisos que necesita tu integracion y envia requests a la URL base de la API.

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

Autenticacion

Use X-API-Key for the most reliable API authentication. Authorization Bearer tokens are also supported when your hosting environment passes Authorization headers to PHP.

A 401 response means the key was not accepted. Check that the key is active, not revoked, copied without spaces, and belongs to the API host you are calling.

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 limites normales. Escrituras y resumenes de analytics usan limites mas estrictos, mientras exports, pruebas de webhook y uploads pequenos usan los limites mas 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 workspace Developer y mantenla privada.

The JavaScript example must be run in a browser console or Node.js, not directly in Windows PowerShell. For PowerShell, use the Windows PowerShell example.

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 codigo 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();

Create a QR code with 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 analytics 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 configuracion de campana

Crea un short link, crea un codigo QR para el mismo destino y revisa el rendimiento desde analytics.

Sincronizar destinos publicos

Actualiza paginas de links, Smart Cards, Support Hubs o destinos QR desde tus herramientas internas.

Crear dashboards de informes

Obtiene resumenes de analytics del workspace y combinalos con tus notas de campana o informes de clientes.

Recibir eventos con webhooks

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

Permisos y endpoints

Elige el conjunto minimo de permisos util

Las claves API tienen alcance. Da a cada integracion solo los permisos que necesita y rota o revoca claves desde el workspace Developer cuando el acceso ya no sea necesario.

Cuenta

  • account:readLeer email de cuenta y detalles de suscripcion

Activos principales

  • links:readLeer shortlinks
  • links:writeCrear y actualizar shortlinks
  • qr:readLeer codigos QR
  • qr:writeCrear y actualizar codigos QR
  • trees:readLeer paginas de links
  • trees:writeCrear y actualizar paginas de links

Engagement

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

Herramientas de workspace

  • 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 Support Hub
  • support:writeGestionar Support Hub
  • drops:readLeer Creator Drops
  • drops:writeCrear y actualizar Creator Drops

Integraciones

  • analytics:readLeer resumenes de analytics
  • 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 Limites del plan actual y costes de endpoints -

Activos principales

GET /api/v1/shortlinks Listar shortlinks links:read
POST /api/v1/shortlinks Crear shortlink links:write
GET /api/v1/qr-codes Listar codigos QR qr:read
POST /api/v1/qr-codes Crear codigo QR qr:write
GET /api/v1/link-pages Listar paginas de links trees:read
POST /api/v1/link-pages Crear pagina de links trees:write

Engagement

GET /api/v1/polls Listar encuestas polls:read
POST /api/v1/polls Crear 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 de workspace

GET /api/v1/campaign-kits Listar Campaign Kits campaigns:read
POST /api/v1/campaign-kits Crear 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 Support Hub support:read
PUT /api/v1/support-hub Actualizar ajustes de Support 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 analytics del workspace 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 utiles del workspace

Usa estas paginas cuando quieras crear claves API, conectar webhooks, exportar datos o pedir ayuda de integracion.

Abrir workspace Developer Crea claves API, revisa limites y gestiona acceso developer. Descargar especificacion OpenAPI Usa la descripcion API legible por maquinas en herramientas developer. Gestionar webhooks Conecta entrega de eventos para acciones compatibles del workspace. Importar y exportar datos Mueve datos del workspace con herramientas compatibles del dashboard. Contactar soporte Pide ayuda con configuracion del workspace, acceso API o preguntas de integracion.