Dokumentation zum Arbeitsbereich

Lynko-Arbeitsbereich-Dokumentation

Erfahre, wie Lynkos Arbeitsbereichsoptionen, Entwickler-API, Webhooks und Statistiken zusammenpassen, damit du Links, QR-Codes und Kampagnenabläufe sicher aufbauen kannst.

Entwicklerarbeitsbereich öffnen OpenAPI-Spezifikation herunterladen

Arbeitsbereich im Überblick

Ein Arbeitsbereich für alle öffentlichen Kontaktpunkte

Ein Lynko-Arbeitsbereich bündelt deine öffentlichen Links, QR-Codes, Seiten, Kampagnen und Berichte. Jedes Tool funktioniert für sich, doch zusammen ermöglichen sie besonders hilfreiche Abläufe.

Kurzlinks

Erstelle übersichtliche Links zum Teilen mit optionalen Statistiken, Ablaufregeln, Passwörtern, Smart Redirects und öffentlichen Auswertungen.

Dynamische QR-Codes

Erstelle QR-Codes, deren gedrucktes Muster gleich bleibt, während du das Ziel später änderst.

Link-Seiten

Veröffentliche Link-in-Bio-Seiten für Social-Media-Profile, Kampagnen, Veranstaltungen und wichtige Ziele.

Campaign Kits

Bündle Kurzlinks, QR-Codes, Landingpages, Umfragen, Reward Unlock-Blöcke und Berichte für eine gemeinsame Aktion.

Smart Cards

Erstelle druckbare oder digitale Karten mit QR-Zielen, die du im Arbeitsbereich jederzeit ändern kannst.

Umfragen und AMA-Seiten

Sammle Stimmen oder Fragen aus deiner Community und behalte alle Aktivitäten in deinem Konto im Blick.

Action Hubs

Teile Links zu Spenden, Shops, Kontaktmöglichkeiten und deiner Community über einen öffentlichen Action Hub.

Insight Pixels

Wähle ein kleines WebP-Motiv, um Seitenaufrufe mit wenig Ladeaufwand zu messen. Bildabrufe geben Hinweise auf Aktivitäten. Schutzfunktionen von E-Mail-Diensten, Zwischenspeicherung und blockierte Bilder können die Zählung beeinflussen.

Workspace options

Was du im Dashboard verwalten kannst

Im Arbeitsbereich kannst du Inhalte erstellen, Statistiken auswerten, Daten importieren und exportieren, Entwicklerzugänge verwalten und Datenschutzeinstellungen festlegen. Die Tarifgrenzen gelten für aktive Elemente oder Elemente mit Statistik. Kurzlinks ohne Statistik sind unbegrenzt verfügbar.

Inhalte verwalten

Erstelle, bearbeite, pausiere, reaktiviere und organisiere deine öffentlichen Lynko-Inhalte im Dashboard.

Statistiken

Sieh dir Klicks, Scans, Aufrufe, Stimmen, Herkunftsseiten, Geräte, Sprachen und Kampagnenergebnisse an, wenn die Erfassung aktiviert ist.

Grenzen je nach Tarif

Für Kurzlinks mit Statistik, veröffentlichte Link-Seiten, aktive QR-Codes, Smart Cards, Umfragen, Insight Pixels, Action Hub-Buttons und Campaign Kits gelten Tarifgrenzen.

Import und Export

Übertrage Daten in deinen Arbeitsbereich oder exportiere sie mit den verfügbaren CSV- und Exportfunktionen, soweit dein Tarif das unterstützt.

Developer access

Erstelle API-Schlüssel mit passenden Berechtigungen, richte Webhooks ein und automatisiere unterstützte Aktionen im Arbeitsbereich.

Datenschutzeinstellungen

Nutze datenschutzfreundliche Statistiken, Lynko-URLs auf der Hauptebene, sichere Uploads und Eigentumsprüfungen in allen Werkzeugen des Arbeitsbereichs.

Statistiken

Finde heraus, was zum nächsten Klick führt

Verfolge Klicks, Scans, Seitenaufrufe, Stimmen und Pixelaktivitäten in einem Arbeitsbereich. Die Erfassung muss aktiviert sein. Jeder Bericht zeigt die Daten, die das jeweilige Tool liefert.

Erkenne die Entwicklung

Sieh dir Tagessummen, die durchschnittliche Aktivität, aktive Tage, Spitzentage und besonders erfolgreiche Inhalte an. Vergleiche sie mit dem vorherigen Zeitraum, sofern dieser noch vollständig verfügbar ist.

Lerne dein Publikum besser kennen

Erkunde verfügbare Angaben zu verweisenden Websites, Gerätetypen, Browsern, Sprachen und ungefähren Standorten. Fehlende oder ausgeblendete Angaben bleiben klar gekennzeichnet. Aus den Aktivitätszahlen lassen sich keine einzelnen Personen erkennen.

Wähle, wie detailliert deine Berichte sein sollen

Jeder Tarif enthält Aktivitätsentwicklungen und voreingestellte Zeiträume. Bezahlte Tarife bieten eine längere Historie und mehr Zeilen in den Auswertungen. Mit Silver und Gold kommen in den wichtigsten Statistikansichten eigene Zeiträume und CSV-Verlaufsberichte hinzu. Ältere Pixeldaten können als Monatssummen vorliegen.

Die Datumsangaben in Berichten verwenden UTC. Die verfügbare Historie richtet sich nach deinem aktuellen Tarif. Ein Upgrade kann bereits gelöschte Daten nicht wiederherstellen.

Statistikumfang der Tarife vergleichen

Entwickler-API

API-Schnellstart

Die Lynko-API ist eine JSON-API für die gesamte Plattform, mit der du Abläufe in deinem Arbeitsbereich automatisieren kannst. Erstelle im Entwicklerbereich einen API-Schlüssel, wähle nur die nötigen Berechtigungen und sende deine Anfragen an die API-Basis-URL.

Basis-URL /api/v1
Authentifizierung X-API-Key or Authorization: Bearer API_KEY
Antwortformat Raw JSON
OpenAPI /openapi.json

Authentifizierung

Verwende X-API-Key für eine möglichst zuverlässige API-Authentifizierung. Authorization-Bearer-Tokens werden ebenfalls unterstützt, wenn deine Hosting-Umgebung Authorization-Header an PHP weitergibt.

Eine 401-Antwort bedeutet, dass der Schlüssel nicht akzeptiert wurde. Prüfe, ob er aktiv und nicht widerrufen ist, ohne Leerzeichen kopiert wurde und zum angesprochenen API-Host gehört.

API-Anfragelimits je nach Tarif
Tarif Anfragen pro Minute Anfragen pro Tag
Free / Bronze 20 1000
Silver 60 5000
Gold 120 20000

Für Lesezugriffe gelten die normalen Limits. Schreibzugriffe und Statistikübersichten haben strengere Limits. Die strengsten Limits gelten für Exporte, Webhook-Tests und kleine Uploads.

Anwendungsbeispiele

So kannst du die API nutzen

Diese Beispiele zeigen typische Abläufe. Ersetze YOUR_API_KEY durch einen Schlüssel mit passenden Berechtigungen aus dem Entwicklerbereich und halte ihn geheim.

Das JavaScript-Beispiel muss in einer Browserkonsole oder in Node.js ausgeführt werden, nicht direkt in Windows PowerShell. Verwende für PowerShell das Windows-PowerShell-Beispiel.

API-Schlüssel prüfen

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

Kurzlink mit cURL erstellen

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"}'

QR-Code mit JavaScript erstellen

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

Einen QR-Code mit Windows PowerShell erstellen

$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

Statistiken mit PHP abrufen

<?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);

Kampagnen automatisch einrichten

Erstelle einen Kurzlink und einen QR-Code für dasselbe Ziel und verfolge anschließend die Ergebnisse in den Statistiken.

Öffentliche Linkziele synchronisieren

Aktualisiere Link-Seiten, Smart Cards, Action Hubs oder QR-Ziele mit deinen eigenen internen Werkzeugen.

Dashboards für Berichte erstellen

Rufe Statistikübersichten aus dem Arbeitsbereich ab und ergänze sie um eigene Kampagnennotizen oder Kundenberichte.

Ereignisse per Webhook empfangen

Nutze Webhooks für Link-Klicks, QR-Scans, Formulareingänge, Kampagnenkontakte, Umfragestimmen und Änderungen bei der Abrechnung.

Berechtigungen und Endpunkte

Vergib nur die nötigen Berechtigungen

API-Schlüssel haben festgelegte Berechtigungen. Gib jeder Integration nur die benötigten Rechte. Ersetze oder widerrufe Schlüssel im Entwicklerbereich, sobald der Zugriff nicht mehr nötig ist.

Konto

  • account:readE-Mail-Adresse und Abodetails des Kontos ansehen

Basiselemente

  • links:readKurzlinks lesen
  • links:writeKurzlinks erstellen und aktualisieren
  • qr:readQR-Codes lesen
  • qr:writeQR-Codes erstellen und aktualisieren
  • trees:readLink-Seiten lesen
  • trees:writeLink-Seiten erstellen und aktualisieren

Interaktionen

  • polls:readUmfragen lesen
  • polls:writeUmfragen erstellen und aktualisieren
  • ama:readAMA-Seiten lesen
  • ama:writeAMA-Seiten verwalten
  • capture:readReward-Unlock-Daten lesen
  • capture:writeReward-Unlock-Blöcke verwalten

Arbeitsbereichstools

  • campaigns:readCampaign Kits lesen
  • campaigns:writeCampaign Kits erstellen und aktualisieren
  • cards:readSmart Cards lesen
  • cards:writeSmart Cards erstellen und aktualisieren
  • counters:readRead Insight Pixels
  • counters:writeCreate and update Insight Pixels
  • support:readAction Hub lesen
  • support:writeAction Hub verwalten
  • drops:readRead Content Drops
  • drops:writeCreate and update Content Drops

Integrationen

  • analytics:readStatistikzusammenfassungen lesen
  • webhooks:writeWebhooks verwalten
  • uploads:writeKleine Mediendateien per API hochladen

Konto

GET /api/v1/me Konto- und API-Schlüsseldetails account:read for email and subscription details
GET /api/v1/rate-limits Aktuelle Tariflimits und Kontingentverbrauch je Endpunkt -

Basiselemente

GET /api/v1/shortlinks Kurzlinks auflisten links:read
POST /api/v1/shortlinks Einen Kurzlink erstellen links:write
GET /api/v1/qr-codes QR-Codes auflisten qr:read
POST /api/v1/qr-codes QR-Code erstellen qr:write
GET /api/v1/link-pages Link-Seiten auflisten trees:read
POST /api/v1/link-pages Link-Seite erstellen trees:write

Interaktionen

GET /api/v1/polls Umfragen auflisten polls:read
POST /api/v1/polls Umfrage erstellen polls:write
GET /api/v1/ama AMA-Einstellungen lesen ama:read
POST /api/v1/ama AMA-Einstellungen erstellen oder aktualisieren ama:write
GET /api/v1/capture/blocks Reward-Unlock-Blöcke auflisten capture:read
POST /api/v1/capture/blocks Reward-Unlock-Block erstellen oder aktualisieren capture:write
GET /api/v1/capture/submissions Reward-Unlock-Einsendungen auflisten capture:read

Arbeitsbereichstools

GET /api/v1/campaign-kits Campaign Kits auflisten campaigns:read
POST /api/v1/campaign-kits Campaign Kit erstellen campaigns:write
GET /api/v1/smart-cards Smart Cards auflisten cards:read
POST /api/v1/smart-cards Smart Card erstellen cards:write
GET /api/v1/counters List Insight Pixels counters:read
POST /api/v1/counters Create an Insight Pixel counters:write
GET /api/v1/support-hub Action-Hub-Einstellungen lesen support:read
PUT /api/v1/support-hub Action-Hub-Einstellungen aktualisieren support:write
GET /api/v1/creator-drops List Content Drops drops:read
POST /api/v1/creator-drops Create a Content Drop drops:write
POST /api/v1/creator-drops/{id}/images Upload one Content Drop image drops:write + uploads:write

Integrationen

GET /api/v1/analytics/summary Statistikzusammenfassung des Arbeitsbereichs lesen analytics:read
GET /api/v1/webhooks Webhook-Endpunkte auflisten webhooks:write
POST /api/v1/webhooks Webhook-Endpunkt erstellen webhooks:write
PATCH /api/v1/webhooks/{id} Webhook-Endpunkt aktualisieren webhooks:write
DELETE /api/v1/webhooks/{id} Webhook-Endpunkt löschen webhooks:write
POST /api/v1/webhooks/{id}/test Webhook-Testereignis in die Warteschlange stellen webhooks:write

Nächste Schritte

Nützliche Links zum Arbeitsbereich

Hier kannst du API-Schlüssel erstellen, Webhooks einrichten, Daten exportieren oder Hilfe bei Integrationen erhalten.

Entwicklerarbeitsbereich öffnen Erstelle API-Schlüssel, prüfe Limits und verwalte Entwicklerzugänge. OpenAPI-Spezifikation herunterladen Verwende die maschinenlesbare API-Beschreibung in deinen Entwicklerwerkzeugen. Webhooks verwalten Richte die Zustellung von Ereignissen für unterstützte Aktionen im Arbeitsbereich ein. Daten importieren und exportieren Übertrage Daten mit den verfügbaren Werkzeugen im Dashboard. Support kontaktieren Hol dir Hilfe beim Einrichten deines Arbeitsbereichs, beim API-Zugang oder bei Integrationsfragen.