REST API — Eigene Integrationen bauen
Vollständiger programmatischer Zugriff auf FastLinkIt. Links erstellen, Kontakte verwalten, Mailings versenden, Zahlungen annehmen und mehr — alles aus deinem Code oder CMS-Plugins.
Links- und QR-Codes-API
Erstelle, lese, aktualisiere und lösche Kurzlinks und QR-Codes programmatisch. Lege eigene Kurzcodes fest, UTM-Parameter, QR-Farben und -Logos, Ablaufdaten und verfolge Klick-Statistiken pro Link — alles über einfache JSON-Endpunkte.
- Vollständige CRUD-Operationen für Links und QR-Codes
- Eigene Kurzcodes mit Verfügbarkeitsprüfung
- UTM-Parameter (source, medium, campaign, term, content)
- QR-Code-Anpassung (Farben, Logo)
- Analytics- und Klick-Statistik-Endpunkte
- Tag-Verwaltung pro Link
Kontakte- und Gruppen-API
Verwalte deine Kontakt-Datenbank programmatisch. Lege Kontakte mit vollständigen Profilen an — inklusive Telefonen, Adressen, Websites und Notizen. Organisiere sie in Gruppen, importiere Mitglieder in Bulk per E-Mail und lass fehlende Kontakte automatisch anlegen.
- Vollständiges Kontakt-CRUD mit verschachtelten Daten
- Telefone, Adressen, Websites und Notizen pro Kontakt
- Kontaktgruppen mit Mitgliederverwaltung
- Bulk-Mitglieder-Import via E-Mail
- Suche und Paginierung
- Bounce- und Abmelde-Tracking
E-Mail-Mailing-API
Komponiere und versende E-Mail-Kampagnen programmatisch. Wähle Empfänger aus Kontakten oder Gruppen, nutze Platzhalter für Personalisierung, reihe Mailings zur Auslieferung ein und verfolge den Zustellstatus pro Empfänger in Echtzeit.
- Mailing-Entwürfe mit HTML-Body anlegen
- Empfänger aus Gruppen und Einzelkontakten hinzufügen
- Platzhalter-Support (Name, Email, FirstName, LastName, Company)
- Queue für Hintergrund-Versand
- Zustell-Tracking pro Empfänger
- Automatisches Filtern von Bounces und Abmeldungen
Organizer-API
Verwalte Planner (Buchungsseiten), Event-Templates, Verfügbarkeits-Slots und Buchungen über die API. Baue eigene Planungs-Workflows, synchronisiere mit externen Kalendern oder integriere Booking-Funktionen in deine Anwendungen.
- Planner-CRUD (Buchungsseiten mit Kurzcode)
- Event-Template-Verwaltung
- Batch-Erstellung von Verfügbarkeits-Slots
- Buchungs-Verwaltung mit Status-Updates
- Status bestätigt, storniert und ausstehend
- Soft-Delete mit Wiederherstellung
Payment-API
Akzeptiere Zahlungen über Stripe-Connect-Destination-Charges. Erstelle Produkte, generiere Checkout-Sessions, verfolge Transaktionen und verarbeite Rückerstattungen — alles programmatisch. HMAC-signierte Webhook-Benachrichtigungen halten deine Systeme synchron.
- Produktverwaltung mit Preisgestaltung
- Quick Checkout (ohne vorher erstelltes Produkt)
- Stripe Destination Charges auf dein verbundenes Konto
- Voll- und Teil-Rückerstattungen
- Webhook-Auslieferung mit HMAC-Signatur-Verifikation
- Quellen-Tracking pro Plattform
GeoIP-Lookup-API
Schlage geografische Standortdaten zu jeder IP-Adresse nach. Hol dir vollständige Details inklusive Kontinent, Land, Stadt, Koordinaten, ISP, Verbindungstyp und Zeitzone. Ergebnisse werden für schnellere Folge-Lookups in der Datenbank gespeichert.
- Voller und vereinfachter Lookup-Endpunkt
- IP des Aufrufers mit /me suchen
- Kontinent-, Land- und Stadt-Auflösung
- Koordinaten und Zeitzone
- ISP- und Verbindungstyp-Erkennung
- EU-Länder-Identifikation
API-Schlüssel mit Scopes
Erzeuge API-Schlüssel mit granularen Berechtigungen. Wähle exakt, auf welche Dienste jeder Schlüssel zugreifen darf — Links, Kontakte, Mailing, Zahlungen und mehr. Folge dem Least-Privilege-Prinzip, ohne auf Funktionen zu verzichten.
- 10 konfigurierbare Scopes (Links, QR, Kontakte, Gruppen, Mailing usw.)
- Vollzugriff oder eingeschränkt pro Schlüssel
- Ablaufdatum pro Schlüssel
- Nutzungs-Tracking (Last-Used-Zeitstempel)
- Sofortiger Widerruf jederzeit
- Zugriffsdurchsetzung gemäß Tarif
Authentifizierung
Drei Authentifizierungsmethoden für jedes Integrations-Szenario. Nutze JWT-Bearer-Token für Server-zu-Server-Kommunikation, API-Schlüssel via X-Api-Key-Header für einfache Integrationen oder Cookie-Auth für die Web-UI.
- JWT-Bearer-Token (Login mit Zugangsdaten)
- API-Schlüssel-Auth via X-Api-Key-Header
- Interaktive OpenAPI-Dokumentation (Scalar-UI)
- Tariflimits werden auf allen Endpunkten durchgesetzt
- CORS-Support für browserbasierte Integrationen
Häufig gestellte Fragen
Alles, was du über die REST-API von FastLinkIt wissen musst.
Welche Authentifizierungsmethoden unterstützt die API?
FastLinkIt unterstützt drei Authentifizierungsmethoden: JWT-Bearer-Token für Server-zu-Server-Integrationen, API-Schlüssel via X-Api-Key-Header für einfachen programmatischen Zugriff und Cookie-Auth für die Web-UI. JWT-Token erhältst du, indem du deine Zugangsdaten an /api/auth/login schickst. API-Schlüssel erzeugst du in deinen Kontoeinstellungen.
Wie erstelle ich einen API-Schlüssel?
Geh im FastLinkIt-Dashboard auf Account > API-Schlüssel. Klicke
„Neuen Schlüssel generieren", gib ihm einen Namen und optional ein Ablaufdatum, dann wähle
die Scopes (Berechtigungen). Der Rohschlüssel wird nur einmal angezeigt — kopiere ihn sofort.
Die Schlüssel haben das Präfix fli_ zur einfachen Erkennung.
Was sind API-Schlüssel-Scopes?
Scopes lassen dich einschränken, was jeder API-Schlüssel darf. Es gibt 10 konfigurierbare Scopes für Links, QR-Codes, Kontakte, Gruppen, Mailing, Organizer, Zahlungen, GeoIP, Dateien und Tags. Du kannst Vollzugriff geben oder einen Schlüssel auf die Dienste beschränken, die er wirklich braucht — Principle of Least Privilege.
Gibt es ein Rate-Limit?
Die API-Nutzung richtet sich nach deinem Abonnement. Jeder Tarif definiert Monatslimits für Link- und QR-Code-Erstellung, Dateigrößen und Speicherkontingent. Die API setzt dieselben Limits durch — ein Starter-Tarif erlaubt also 10 Links pro Monat, egal ob über Dashboard oder API erstellt.
Welche Tarife enthalten API-Zugriff?
API-Zugriff ist in allen Tarifen verfügbar. Free-Nutzer können bis zu 5 Links pro Monat über die API anlegen. Höhere Tarife schalten mehr Link-Kapazität, größere Datei-Uploads, mehr Speicher und Pro-Features wie Kontakte, Mailing und Organizer frei.
Wo finde ich die vollständige API-Dokumentation?
Die vollständige interaktive API-Dokumentation gibt's über die
Scalar-UI unter /scalar/v1 auf deiner FastLinkIt-Instanz.
Die OpenAPI-Spezifikation wird unter /openapi/v1.json veröffentlicht — du
kannst sie in Postman, Insomnia oder jedes andere OpenAPI-Tool importieren.
Kann ich Zahlungen über die API annehmen?
Ja. Die Payment-API erlaubt dir, Produkte zu erstellen, Stripe-Checkout-Sessions mit Destination Charges zu generieren, Transaktionen zu verfolgen und volle oder teilweise Rückerstattungen vorzunehmen. Zahlungen laufen über Stripe Connect, das Geld geht direkt auf dein verbundenes Stripe-Konto, abzüglich einer konfigurierbaren Plattformgebühr. HMAC-signierte Webhook-Benachrichtigungen halten deine Systeme synchron.
Starte heute mit der API zu bauen
Lege dein kostenloses Konto in Sekunden an. Keine Kreditkarte nötig.
Generiere einen API-Schlüssel, durchstöbere die interaktive Doku und ship deine erste Integration.