API Skracania Linków Linkly

Twórz, aktualizuj i zarządzaj linkami programowo, używając API Skracania Linków Linkly.

Pokrewne: API Analityki | Webhooks

Zanim zaczniesz

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

Działa to przy tworzeniu i aktualizacji linków.

Zaoszczędź czas i pozwól nam wykonać ciężką pracę:

1. 1
   Poniżej znajdziesz żądania API do tworzenia linków.
2. 2
   Skopiuj żądania w całości. Możesz sprawdzić, że działają dla Ciebie.
3. 3
   Poproś ChatGPT lub równoważny system, aby dostosował te żądania do kodu źródłowego Twojej aplikacji. Nie ma potrzeby spędzania czasu na skomplikowanej integracji. Nasze API jest w pełni konsumowalne maszynowo.

---

Specyfikacja OpenAPI 3.0

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

API Linkly jest dokumentowane przy użyciu standardu OpenAPI, który wykracza poza to, co podano poniżej. Te same punkty końcowe są również dostępne jako kolekcja Postmana jednym klikiem.

Wyświetl Specyfikację OpenAPI

Uruchom w Postmanie

Autoryzacja

Będziesz potrzebować:

• Twój Klucz API
• ID Workspace

Możesz uzyskać te szczegóły z wnętrza Linkly.

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

Tworzenie lub aktualizacja linku

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

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

z poniższymi polami w treści.

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

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

Zalecamy używanie JSON ze specyfikacją Open API.

Przykładowe żądanie przy użyciu curl

Kod poniżej 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 id linku.

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

Aktualizacja linku

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ć, wraz ze zmianami.

Tworzenie rotatorów za pośrednictwem API

Aby utworzyć rotator, prześlij pole o nazwie rules jako tablicę JSON, wraz z powyższym ładunkiem linku. 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"}
]

Tworzenie geo-przekierowań za pośrednictwem API

Aby dokonać przekierowania według kraju, prześlij pole o nazwie rules jako tablicę JSON, wraz z powyższym ładunkiem linku. 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"}
]

Kraj to dwuliterowy kod kraju ISO 3166.

Tworzenie przekierowań urządzeń za pośrednictwem API

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

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

Tworzenie lub aktualizacja wielu linków w jednym żądaniu

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

Aby to zrobić, prześlij swój klucz API w ramach żą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 w powyższych przypadkach poszczególnych linków, ale zawiń żądania linków w tablicę 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.

Pamiętaj, że duże żądania mogą zająć do 60 sekund. Jeśli żądania trwają dłużej, będą się nie powieść, i powinieneś rozdzielić pracę na mniejsze części.

Limity szybkości

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

Pokrewne

• API Analityki - Eksportuj dane kliknięć i raporty ruchu
• Webhooks - Powiadomienia kliknięć w czasie rzeczywistym
• Integracja Zapier - Integracje bez kodu