Linkly's Link Shortening API

Erstellen, aktualisieren und verwalten Sie Links programmgesteuert mit Linkly's Link Shortening API.

Related: Analytics API | Webhooks

Bevor Sie beginnen

Linkly generiert API-Anfragen in der Benutzeroberfläche für Sie zum Kopieren und Einfügen in Ihre Anwendungen.

Dies funktioniert für die Link-Erstellung und Link-Aktualisierung.

Sparen Sie Zeit und lassen Sie uns die harte Arbeit machen:

1. 1
   Siehe unten für Link-Erstellungs-API-Anfragen.
2. 2
   Kopieren Sie die Anfragen vollständig. Sie können überprüfen, ob sie für Sie funktionieren.
3. 3
   Bitten Sie ChatGPT oder ein äquivalentes Tool, diese Anfragen an Ihren Anwendungscode anzupassen. Es ist nicht erforderlich, viel Zeit für eine komplexe Integration aufzuwenden. Unsere API ist vollständig maschinenlesbar.

---

OpenAPI 3.0 Spezifikation

Sie können API-Anfragen direkt aus der Linkly-Benutzeroberfläche generieren.

Linkly's API ist nach dem OpenAPI-Standard dokumentiert, der über das hinausgeht, was unten bereitgestellt wird. Die gleichen Endpunkte sind auch als One-Click-Postman-Sammlung verfügbar.

View OpenAPI Spec

Run in Postman

Autorisierung

Sie benötigen:

• Ihren API-Schlüssel
• Workspace-ID

Sie können diese Details in Linkly finden.

1. 1
   Melden Sie sich bei Linkly an.
2. 2
   Klicken Sie auf Settings.
3. 3
   Klicken Sie auf API Keys.

Erstellen oder Aktualisieren eines Links

Um einen Link zu erstellen, müssen Sie nur eine POST-Anfrage an senden:

https://app.linklyhq.com/api/v1/link

mit den folgenden Feldern im Text.

Der Kodierungstyp ist x-www-form-urlencoded oder application/json.

Wenn Sie das Feld Rules absenden, müssen Sie application/json verwenden.

Wir empfehlen Ihnen, JSON mit der Open API-Spezifikation zu verwenden.

Beispiel-Anfrage mit curl

Der folgende Code zeigt, wie Sie eine API-Anfrage zum Erstellen eines Links stellen.

curl -X POST https://app.linklyhq.com/api/v1/link
-H 'cache-control: no-cache'
-d 'api_key=your_secret_key&workspace_id=1&url=http%3A%2F%2Fwww.wikijob.co.uk&name=Test%20Link'

Eine erfolgreiche Antwort gibt ein JSON-Objekt zurück, das den Link darstellt, zusammen mit einer Link-ID.

{
    "id": 9512,
    "url": "https://www.wikijob.co.uk",
    "name": "Test Link",
    "note": null,
    "head_tags": null,
    "body_tags": null,
    "linkify_words": null,
    "replacements": null,
    "enabled": true,
    "cloaking": false,
    "forward_params": false,
    "hide_referrer": false,
    "block_bots": false,
    "skip_social_crawler_tracking": false,
    "public_analytics": false,
    "password": null,
    "domain": null,
    "slug": null,
    "utm_source": null,
    "utm_medium": null,
    "utm_campaign": null,
    "utm_term": null,
    "utm_content": null,
    "og_title": null,
    "og_description": null,
    "og_image": null,
    "fb_pixel_id": null,
    "tiktok_pixel_id": null,
    "ga4_tag_id": null,
    "gtm_id": null,
    "full_url": "https://l.linklyhq.com/l/2TQ",
    "rules": [],
    "expiry_datetime": null,
    "expiry_destination": null,
    "expiry_clicks": null,
    "qr_styles": null,
    "webhooks": [],
    "notify_user_ids": [],
    "workspace_id": 1448,
    "deleted": false
}

Aktualisieren eines Links

Um einen Link zu aktualisieren, senden Sie die gleiche Anfrage, die Sie zum Erstellen eines Links verwenden würden, aber fügen Sie das Feld id für den Link hinzu, den Sie aktualisieren möchten, zusammen mit den Änderungen.

Erstellen von Rotierern über API

Um einen Rotierer zu erstellen, senden Sie ein Feld namens rules als JSON-Array zusammen mit der obigen Link-Payload. Sie müssen application/json verwenden, um JSON-Arrays zu senden.

Zum Beispiel:

[
  {"what": "rotator", "url": "https://www.microsoft.com", "percentage": "50"},
  {"what": "rotator", "url": "https://www.apple.com", "percentage": "50"}
]

Erstellen von Geo-Umleitungen über API

Um nach Land umzuleiten, senden Sie ein Feld namens rules als JSON-Array zusammen mit der obigen Link-Payload. Sie müssen application/json-Kodierung verwenden, um JSON-Arrays zu senden.

Zum Beispiel:

[
  {"what": "country", "url": "https://www.microsoft.com", "matches": "UK"},
  {"what": "country", "url": "https://www.apple.com", "matches": "US"}
]

Das Land ist der Alpha-2 ISO 3166-Ländercode.

Erstellen von Geräte-Umleitungen über API

Um nach Gerät umzuleiten, senden Sie ein Feld namens rules als JSON-Array zusammen mit der obigen Link-Payload.

Zum Beispiel:

[
  {"what": "platform", "url": "https://www.google.com", "matches": "windows"},
  {"what": "platform", "url": "https://www.apple.com", "matches": "ios"}
]

Wobei das Feld matches einer der folgenden ist:

• ios
• android
• windows
• linux
• mac

Erstellen oder Aktualisieren mehrerer Links in einer Anfrage

Linkly unterstützt die Erstellung/Änderung von bis zu 1000 Links pro Anfrage.

Dazu senden Sie Ihren API-Schlüssel wie folgt als Teil der Anfrage:

https://app.linklyhq.com/api/v1/link?api_key=XXXXXXXXXXX

Verwenden Sie dann das gleiche Schema wie oben für die einzelnen Link-Fälle, umhüllen Sie aber die Link-Anfragen in einem Array der Form:

[{link}, {link}]

Hier ist eine vollständige Anfrage, die zwei Links aktualisiert:

wget --no-check-certificate \
  --method POST \
  --timeout=0 \
  --header 'Content-Type: application/json' \
  --body-data '[
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://nature.com",
        "name": "Test",
        "id": LINK_ID
    },
    {
        "workspace_id": "WORKSPACE_ID",
        "url": "https://science.com",
        "id": LINK_ID
    }
]' \
   'https://app.linklyhq.com/api/v1/workspace/WORKSPACE_ID/links?api_key=API_KEY'

Dies funktioniert für sowohl Erstellungs- als auch Aktualisierungsaktionen.

Bitte beachten Sie, dass große Anfragen bis zu 60 Sekunden dauern können. Wenn Anfragen länger dauern, schlagen sie fehl, und Sie sollten Ihre Arbeitslast in kleinere Teile aufteilen.

Ratenlimits

Die Link Shortening API ist auf 20 Anfragen/Sekunde begrenzt. Bis zu 200 Anfragen pro Sekunde sind auf Anfrage verfügbar. Sie können bis zu 1000 Links in einer einzelnen Anfrage hochladen.

Verwandt

• Analytics API - Exportieren Sie Klickdaten und Verkehrsberichte
• Webhooks - Echtzeit-Klickbenachrichtigungen
• Zapier Integration - Codelose Integrationen