Linklys Link-Kürzungs-API

Erstellen, aktualisieren und verwalten Sie Links programmatisch mit Linklys Link-Kürzungs-API.

Verwandte Artikel: Analytics-API | Webhooks

Linkly generiert API-Anfragen in der Benutzeroberfläche, die Sie in Ihre Anwendungen kopieren und einfügen können.

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

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

1. 1Siehe unten für API-Anfragen zur Link-Erstellung.
2. 2Kopieren Sie die Anfragen vollständig. Sie können überprüfen, ob sie für Sie funktionieren.
3. 3Bitten Sie ChatGPT oder ein Äquivalent, diese Anfragen in Quellcode für Ihre Anwendung umzuwandeln. Es ist nicht notwendig, Zeit mit einer komplexen Integration zu verbringen. Unsere API ist vollständig maschinenlesbar.

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

Linklys API ist mit dem OpenAPI-Standard dokumentiert, der über das unten Bereitgestellte hinausgeht.

Sie benötigen:

• Ihren API-Schlüssel
• Workspace-ID

Sie können diese Details innerhalb von Linkly abrufen.

1. 1Melden Sie sich bei Linkly an.
2. 2Klicken Sie auf Einstellungen.
3. 3Klicken Sie auf API-Schlüssel.

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

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

mit den folgenden Feldern im Body senden.

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

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

Wir empfehlen die Verwendung von JSON mit der OpenAPI-Spezifikation.

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 repräsentiert, zusammen mit einer Link-ID.

{
    "id": 9512,
    "alias": null,
    "url": "https://www.wikijob.co.uk",
    "name": "Test Link",
    "note": null,
    "head_tags": null,
    "body_tags": null,
    "linkify_words": null,
    "enabled": true,
    "cloaking": false,
    "replacements": 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,
    "full_url": "https://l.linklyhq.com/l/2TQ",
    "block_bots": false,
    "rules": [],
    "workspace_id": 1448,
    "referer_mode": null,
    "custom_referer": null,
    "click_fraud_mode": null,
    "deleted": false
}

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

Um einen Rotator zu erstellen, übermitteln 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"}
]

Um nach Land weiterzuleiten, übermitteln Sie ein Feld namens rules als JSON-Array zusammen mit der obigen Link-Payload. Sie müssen die Kodierung application/json 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.

Um nach Gerät weiterzuleiten, übermitteln 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 eines der folgenden ist:

• ios
• android
• windows
• linux
• mac

Linkly unterstützt das Erstellen/Ändern von bis zu 1000 Links pro Anfrage.

Übermitteln Sie dazu Ihren API-Schlüssel als Teil der Anfrage wie folgt:

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

Verwenden Sie dann dasselbe Schema wie oben für die einzelnen Link-Fälle, aber wickeln Sie die Link-Anfragen in ein 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 sowohl für Erstellungs- als auch für Aktualisierungsaktionen.

Bitte beachten Sie, dass eine große Anfrage bis zu 60 Sekunden dauern kann. Wenn Anfragen länger dauern, schlagen sie fehl, und Sie sollten in Erwägung ziehen, Ihre Arbeitslast in kleinere Teile aufzuteilen.

Die Link-Kürzungs-API ist auf 20 Anfragen/Sekunde begrenzt. Auf Anfrage sind bis zu 200 Anfragen pro Sekunde verfügbar. Sie können bis zu 1000 Links in einer einzigen Anfrage hochladen.

• Analytics-API - Exportieren Sie Klickdaten und Traffic-Berichte
• Webhooks - Echtzeit-Klickbenachrichtigungen
• Zapier-Integration - No-Code-Integrationen