API skracania linków Linkly

Twórz, aktualizuj i zarządzaj linkami programistycznie, korzystając z API skracania linków Linkly.

Powiązane: API analityki | Webhooki

Linkly generuje żądania API w interfejsie, które możesz skopiować i wkleić do swoich aplikacji.

Działa to dla tworzenia linków i aktualizacji linków.

Oszczędzaj czas i pozwól nam wykonać ciężką pracę:

1. 1Zobacz poniżej żądania API do tworzenia linków.
2. 2Skopiuj żądania w całości. Możesz sprawdzić, czy działają w Twoim przypadku.
3. 3Poproś ChatGPT lub równoważne narzędzie o dostosowanie tych żądań do kodu źródłowego Twojej aplikacji. Nie ma potrzeby spędzać czasu na skomplikowanej integracji. Nasze API jest w pełni czytelne maszynowo.

Możesz generować żądania API bezpośrednio z interfejsu użytkownika Linkly.

API Linkly jest udokumentowane przy użyciu standardu OpenAPI, który wykracza poza to, co przedstawiono poniżej.

Będziesz potrzebować:

• Swojego klucza API
• ID przestrzeni roboczej

Możesz uzyskać te dane wewnątrz Linkly.

1. 1Zaloguj się do Linkly.
2. 2Kliknij Ustawienia.
3. 3Kliknij Klucze API.

Aby utworzyć link, wystarczy wysłać żądanie POST do:

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

z następującymi polami w treści.

Typ kodowania to x-www-form-urlencoded lub application/json.

Jeśli wysyłasz pole Rules, musisz użyć application/json.

Zalecamy używanie JSON ze specyfikacją Open API.

Poniższy kod ilustruje, jak wykonać żądanie API w celu utworzenia linku.

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'

Pomyślna odpowiedź zwróci obiekt JSON reprezentujący link, wraz z identyfikatorem linku.

{
    "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
}

Aby zaktualizować link, wyślij to samo żądanie, które użyłbyś do utworzenia linku, ale dołącz pole id dla linku, który chcesz zaktualizować, oraz zmiany.

Aby utworzyć rotator, prześlij pole o nazwie rules jako tablicę JSON, wraz z ładunkiem linku powyżej. Musisz użyć application/json, aby wysłać tablice JSON.

Na przykład:

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

Aby przekierować według kraju, prześlij pole o nazwie rules jako tablicę JSON, wraz z ładunkiem linku powyżej. Musisz użyć kodowania application/json, aby wysłać tablice JSON.

Na przykład:

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

Krajem jest dwuliterowy kod kraju ISO 3166 alpha-2.

Aby przekierować według urządzenia, prześlij pole o nazwie rules jako tablicę JSON, wraz z ładunkiem linku powyżej.

Na przykład:

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

Gdzie pole matches to jedno z:

• ios
• android
• windows
• linux
• mac

Linkly obsługuje tworzenie/modyfikowanie do 1000 linków na żądanie.

Aby to zrobić, prześlij swój klucz API jako część żądania w następujący sposób:

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

Następnie użyj tego samego schematu, co powyżej dla pojedynczych przypadków linków, ale opakuj żądania linków w tablicę, w postaci:

[{link}, {link}]

Oto kompletne żądanie, które zaktualizuje dwa linki:

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'

Działa to zarówno dla akcji tworzenia, jak i aktualizacji.

Należy pamiętać, że przetworzenie dużego żądania może zająć do 60 sekund. Jeśli żądania trwają dłużej niż to, zakończą się niepowodzeniem i powinieneś rozważyć podzielenie obciążenia na mniejsze części.

API skracania linków jest ograniczone do 20 żądań/sekundę. Do 200 żądań/sekundę jest dostępnych na życzenie. Możesz przesłać do 1000 linków w jednym żądaniu.

• API analityki - Eksportuj dane kliknięć i raporty ruchu
• Webhooki - Powiadomienia o kliknięciach w czasie rzeczywistym
• Integracja Zapier - Integracje bez kodu