Entwickler · Integrationen · Automatisierung
Erstellen Sie Kurzlinks und QR-Codes direkt aus Ihrer eigenen Software. Eine REST-API, dokumentiert auf einer Seite, ohne SDK-Zwang.
§ 01 — Was die API kann
Mit einem POST-Request einen neuen Kurzlink mit Ziel-URL, eigenem Slug und UTM-Parametern. Die API gibt sofort die fertige kurze URL zurück — bereit zum Verteilen.
POST /v1/links
{
"target_url": "https://example.at/...",
"slug": "sommer25",
"domain": "go.example.at",
"utm": {
"source": "newsletter",
"campaign": "sommer25"
}
}Ab Pro-Tarif
PNG, SVG oder PDF — mit oder ohne Logo, statisch oder dynamisch. Ideal für die Bürger-App, die täglich Hunderte QR-Codes für individuelle Vorgänge erzeugt.
POST /v1/qr-codes
{
"type": "static",
"content": "https://example.at",
"format": "svg",
"logo_url": "https://example.at/logo.png",
"color": "#0A0908"
}Ab Pro-Tarif
Klick-Zahlen, Trends, Aggregat-Daten — alles anonymisiert nach DSGVO. Ideal für eigene Reports und Dashboards in Ihrer bestehenden Software.
GET /v1/links/abc12/stats
?from=2026-01-01
&to=2026-01-31
→ {
"clicks": 247,
"unique": 189,
"countries": {...}
}Ab Pro-Tarif
§ 02 — Vertrauen
Die kürze-API verwendet Bearer-Token-Authentifizierung. Jeder Account kann mehrere API-Schlüssel mit unterschiedlichen Berechtigungen anlegen — ein Schlüssel für die Produktivumgebung, einer für Tests, einer für die Integration mit Drittsystemen.
Schlüssel sind jederzeit widerrufbar. Bei Verdacht auf Kompromittierung können Sie einen Schlüssel mit einem Klick deaktivieren, ohne andere Integrationen zu stören.
Die API erzwingt HTTPS, ratenbegrenzt automatisch (Pro: 10.000 Anfragen/Tag, Agentur: unbegrenzt) und protokolliert jeden Aufruf in Ihrem Audit-Log.
curl -X GET https://api.kuerze.at/v1/links \
-H "Authorization: Bearer kuerze_pk_..."{
"data": [
{
"id": "lnk_abc123",
"slug": "sommer25",
"target_url": "https://example.at/...",
"clicks_count": 247,
"created_at": "2026-01-15T10:23:00Z"
}
],
"meta": {
"total": 1,
"page": 1
}
}§ 03 — Klarheit
Eigene SDKs für 17 Sprachen.
Die API ist REST, JSON, Standard-HTTP. Jede Sprache der letzten 20 Jahre kann sie ansprechen. SDKs verstecken nur Komplexität, die wir nicht haben.
GraphQL-Endpoint.
REST ist für unseren Anwendungsfall vollständig ausreichend. Wir bauen nicht zwei Schnittstellen, die dasselbe können.
Webhooks für jeden Event.
Webhooks gibt es für drei klar definierte Events: Link erstellt, Link archiviert, hohe Klickfrequenz. Mehr ist Lärm.
OAuth-Flow für Endbenutzer.
Die API ist für Server-zu-Server-Integration, nicht für Endbenutzer-Logins. Keine Drittanbieter-Tokens, keine OAuth-Komplexität.
§ 04 — Praxis
Anwendungsfall 01
Ein Stadtwerk betreibt eine eigene Bürger-App für Mängelmeldungen. Bei jeder neuen Meldung erzeugt die App im Hintergrund einen QR-Code mit der Vorgangsnummer, den der Bürger später am Empfang wieder vorzeigt. Die kürze-API erstellt diese QR-Codes on-demand, integriert in den bestehenden Workflow.
# Beim Erstellen einer neuen Meldung
qr_response = kuerze.qr_codes.create(
type="static",
content=f"https://buergerservice.example.at/vorgang/{vorgang_id}",
format="svg"
)Anwendungsfall 02
Eine Werbeagentur betreut zehn Kunden, jede Kampagne hat eigene UTM-Parameter. Statt manuell Hunderte Links zu erstellen, schreibt das Agentur-CRM automatisch beim Anlegen einer neuen Kampagne den passenden Kurzlink direkt mit. Im Reporting erscheint die Klick-Zahl neben den anderen Kampagnen-Metriken.
for variant in kampagne.varianten:
link = kuerze.links.create(
target_url=variant.landing_page,
slug=f"{kampagne.code}-{variant.kuerzel}",
utm={
"source": variant.kanal,
"campaign": kampagne.code
}
)Anwendungsfall 03
Ein Verein verkauft Tickets für ein Konzert. Jedes Ticket hat einen eindeutigen QR-Code, der am Einlass gescannt wird. Die kürze-API generiert die QR-Codes beim Kauf, der Verein speichert nur die Slug-IDs in seiner eigenen Datenbank.
ticket_qr = kuerze.qr_codes.create(
type="static",
content=f"TICKET-{ticket.id}",
format="png"
)
ticket.qr_url = ticket_qr.image_url§ 05 — Verfügbarkeit
Die API ist Bestandteil aller Pro- und Agentur-Tarife. Im Pro-Tarif sind 10.000 Anfragen pro Tag inkludiert, im Agentur-Tarif unbegrenzt. Beide Limits reichen für die meisten Integrationen.
Bei höheren Anforderungen sprechen Sie uns an — wir konfigurieren die Limits passend, ohne Aufpreis.
Pricing ansehen →Lesen Sie die Dokumentation, fordern Sie Ihren API-Schlüssel an, oder schreiben Sie uns mit konkreten Fragen.
Keine Kreditkarte · 14 Tage testen · Dokumentation öffentlich zugänglich