Kurzlinks für SaaS: URLW über API in Ihr Produkt integrieren

Moderne SaaS-Produkte generieren täglich zu teilende URLs: Team-Einladungen, Dokumenten-Shares, Download-Links, Statusseiten... Die direkte Integration eines URL-Verkürzers in Ihr SaaS verbessert die Nutzererfahrung und gibt Ihnen wertvolle Einblicke in das Sharing-Verhalten. Die URLW-API macht diese Integration schnell und zuverlässig.

Warum SaaS von Kurzlinks profitieren

Die Integration eines URL-Verkürzers in ein SaaS bedient mehrere konkrete Anwendungsfälle:

• Einladungslinks: „Kollegen einladen" generiert einen personalisierten Kurzlink mit dem Namen des Einladers und einem Einladungs-Token – lesbar, per SMS oder E-Mail teilbar
• Inhalts-Sharing: Ihre Nutzer teilen Berichte, Dashboards oder Dokumente. Ein Kurzlink go.ihr-saas.de/bericht-xyz wirkt deutlich professioneller als die interne URL Ihrer App
• Downloads und Exporte: Temporäre Download-Links sind oft lang und komplex. Ein Kurzlink mit Ablaufdatum ist für den Nutzer beruhigender
• Transaktionale Benachrichtigungs-E-Mails: Links in Ihren Benachrichtigungs-E-Mails können von einer konsistenten Domain profitieren
• Analytics zu Shares: Messen Sie, wie viele von Ihren Nutzern erstellte Links tatsächlich geklickt werden – eine wertvolle Engagement-Metrik

Die URLW-API in Ihr SaaS integrieren

Hier ist ein Beispiel für die Integration, um beim Teilen eines Berichts automatisch einen Kurzlink zu generieren:

curl -X POST https://urlw.fr/api/v1/links \
-H "Authorization: Bearer IHR_API_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.ihr-saas.de/berichte/rpt_a1b2c3?token=eyJhbGc...",
"slug": "bericht-juni-team-acme",
"domain": "share.ihr-saas.de",
"expires_at": "2025-07-31T23:59:59Z",
"metadata": {
  "user_id": "usr_456",
  "report_id": "rpt_a1b2c3",
  "workspace": "acme-corp"
}
}'

Das Feld metadata ermöglicht es Ihnen, interne Kennungen zu speichern, die es Ihnen erlauben, jeden URLW-Klick mit einem Nutzer und einem spezifischen Objekt in Ihrer Datenbank zu verknüpfen.

URLW-Webhooks für Echtzeit-Benachrichtigungen

Statt die URLW-API zu pollen, um neue Klicks zu erkennen, konfigurieren Sie Webhooks, um bei jedem Ereignis eine HTTP-Benachrichtigung in Echtzeit zu erhalten:

• Ereignis link.clicked: wird bei jedem Klick auf einen Link empfangen. Enthält die Link-ID, Datum/Uhrzeit, Land und Gerätetyp.
• Ereignis link.expired: benachrichtigt, wenn ein Link sein Ablaufdatum oder seine maximale Klickanzahl erreicht.
• Ereignis link.created: nützlich zur Synchronisierung von über die URLW-Oberfläche erstellten Links mit Ihrer Datenbank.

Webhook-Konfiguration in URLW:

curl -X POST https://urlw.fr/api/v1/webhooks \
-H "Authorization: Bearer IHR_API_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.ihr-saas.de/webhooks/urlw",
"events": ["link.clicked", "link.expired"],
"secret": "ihr_webhook_secret_zur_signaturverifikation"
}'

Best Practices für die SaaS-Integration

• Verwenden Sie eine dedizierte Domain für Ihre Shares: share.ihr-saas.de oder go.ihr-saas.de stärkt Ihre Markenidentität bei jedem Share
• Erstellen Sie Links asynchron: Blockieren Sie niemals Ihre Benutzeroberfläche, während Sie auf die Antwort der URLW-API warten. Erstellen Sie den Link im Hintergrund und senden Sie ihn dem Nutzer zurück, sobald er verfügbar ist
• Verwalten Sie Ablaufdaten auf der Geschäftsebene: Legen Sie Gültigkeitsdauern fest, die mit Ihrer Anwendungslogik übereinstimmen (z. B.: Einladungslink 7 Tage gültig)
• Speichern Sie die URLW-ID in Ihrer Datenbank: Bewahren Sie die URLW-Link-ID mit dem zugehörigen Objekt auf, um Statistiken abfragen oder den Link bei Bedarf löschen zu können
• Testen Sie die Resilienz: Was passiert, wenn die URLW-API vorübergehend nicht verfügbar ist? Ihre App muss graceful auf die vollständige URL zurückfallen

Lesen Sie die vollständige URLW-API-Dokumentation und die SaaS-Tarifpläne. Erstellen Sie Ihr Konto, um mit der Integration zu beginnen.