Linkly's Link Shortening API

Maak, werk bij en beheer links programmatisch met Linkly's Link Shortening API.

Gerelateerd: Analytics API | Webhooks

Linkly genereert API-verzoeken in de interface die u kunt kopiëren en plakken in uw applicaties.

Dit werkt voor het aanmaken en bijwerken van links.

Bespaar tijd en laat ons het zware werk doen:

1. 1Zie hieronder voor API-verzoeken voor het aanmaken van links.
2. 2Kopieer de verzoeken in hun geheel. U kunt verifiëren dat ze voor u werken.
3. 3Vraag ChatGPT of een equivalent om deze verzoeken aan te passen naar broncode voor uw applicatie. Er is geen noodzaak om tijd te besteden aan een complexe integratie. Onze API is volledig machine-leesbaar.

U kunt API-verzoeken rechtstreeks genereren vanuit de Linkly gebruikersinterface.

Linkly's API is gedocumenteerd volgens de OpenAPI-standaard, die verder gaat dan wat hieronder wordt verstrekt.

U heeft nodig:

• Uw API-sleutel
• Werkruimte-ID

U kunt deze gegevens ophalen vanuit Linkly.

1. 1Log in bij Linkly.
2. 2Klik op Instellingen.
3. 3Klik op API-sleutels.

Om een link aan te maken, hoeft u alleen maar een POST-verzoek te sturen naar:

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

met de volgende velden in de body.

Het coderingstype is x-www-form-urlencoded of application/json.

Als u het veld Rules indient, moet u application/json gebruiken.

We raden aan dat u JSON gebruikt met de Open API spec.

De onderstaande code illustreert hoe u een API-verzoek kunt doen om een link aan te maken.

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'

Een succesvol antwoord zal een JSON-object retourneren dat de link vertegenwoordigt, samen met een 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
}

Om een link bij te werken, stuurt u hetzelfde verzoek dat u zou gebruiken om de link aan te maken, maar neemt u het veld id op voor de link die u wilt bijwerken, evenals de wijzigingen.

Om een rotator aan te maken, dient u een veld genaamd rules in als een JSON-array, samen met de bovenstaande link payload. U moet application/json gebruiken om JSON-arrays te verzenden.

Bijvoorbeeld:

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

Om per land om te leiden, dient u een veld genaamd rules in als een JSON-array, samen met de bovenstaande link payload. U moet application/json-codering gebruiken om JSON-arrays te verzenden.

Bijvoorbeeld:

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

Het land is de alpha-2 ISO 3166 landcode.

Om per apparaat om te leiden, dient u een veld genaamd rules in als een JSON-array, samen met de bovenstaande link payload.

Bijvoorbeeld:

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

Waarbij het veld matches een van de volgende is:

• ios
• android
• windows
• linux
• mac

Linkly ondersteunt het aanmaken/wijzigen van maximaal 1000 links per verzoek.

Om dit te doen, dient u uw API-sleutel in als onderdeel van het verzoek als volgt:

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

Gebruik vervolgens hetzelfde schema als hierboven voor de individuele linkcases, maar verpak de linkverzoeken in een array, van de vorm:

[{link}, {link}]

Hier is een compleet verzoek dat twee links zal bijwerken:

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'

Dit werkt zowel voor aanmaak- als bijwerkacties.

Houd er rekening mee dat het tot 60 seconden kan duren voor een groot verzoek. Als verzoeken langer duren, zullen ze mislukken en moet u overwegen uw werkbelasting op te splitsen in kleinere stukken.

De link shortening API is beperkt tot 20 verzoeken/seconde. Tot 200 verzoeken per seconde zijn beschikbaar op aanvraag. U kunt maximaal 1000 links in één verzoek uploaden.

• Analytics API - Exporteer klikgegevens en verkeersrapporten
• Webhooks - Real-time klikmeldingen
• Zapier Integration - No-code integraties