Linkly'nin Link Kısaltma API'si

Linkly'nin Link Kısaltma API'sini kullanarak programlı olarak linkler oluşturun, güncelleyin ve yönetin.

İlgili: Analytics API | Webhooks

Başlamadan önce

Linkly, API isteklerini arayüzde sizin için oluşturur ve kopyalamak için hazır hale getirir.

Bu, link oluşturma ve link güncelleme için geçerlidir.

Zaman tasarrufu yapın ve bunu bize bırakın:

1. 1
   Link oluşturma API istekleri için aşağıya bakın.
2. 2
   İsteklerin tamamını kopyalayın. Sizin için çalışıp çalışmadığını doğrulayabilirsiniz.
3. 3
   ChatGPT veya eşdeğerini kullanarak bu istekleri uygulamanız için kaynak koda uyarlamasını isteyin. Karmaşık bir entegrasyon yapmaya zaman harcamanıza gerek yoktur. API'miz tamamen makine tarafından tüketilebilir.

---

OpenAPI 3.0 spesifikasyonu

Linkly kullanıcı arayüzünden doğrudan API istekleri oluşturabilirsiniz.

Linkly'nin API'si OpenAPI standardı kullanılarak belgelenmiştir ve aşağıda sağlananların ötesine geçer. Aynı uç noktalar tek tıkla Postman koleksiyonu olarak da mevcuttur.

OpenAPI Spec'i Görüntüle

Postman'da Çalıştır

Yetkilendirme

İhtiyacınız olan:

• API Anahtarınız
• Çalışma Alanı Kimliği

Bu detayları Linkly'nin içinden alabilirsiniz.

1. 1
   Linkly'ye giriş yapın.
2. 2
   Ayarlar'a tıklayın.
3. 3
   API Anahtarları'na tıklayın.

Link oluşturma veya güncelleme

Bir link oluşturmak için yapmanız gereken tek şey bir POST isteği göndermektir:

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

istek gövdesinde aşağıdaki alanlarla birlikte.

Kodlama türü x-www-form-urlencoded veya application/json şeklindedir.

Kurallar alanını gönderiyorsanız, application/json kullanmanız gerekir.

OpenAPI spesifikasyonu ile JSON kullanmanızı öneririz.

curl kullanarak örnek istek

Aşağıdaki kod, bir link oluşturmak için API isteği yapmayı göstermektedir.

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'

Başarılı bir yanıt, linki temsil eden bir JSON nesnesi ve bir link kimliği döndürecektir.

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

Link güncelleme

Bir linki güncellemek için, linki oluşturmak için kullanacağınız aynı isteği gönderin, ancak güncellemek istediğiniz linkin id alanını ve değişiklikleri ekleyin.

API aracılığıyla döndürücü oluşturma

Bir döndürücü oluşturmak için, yukarıdaki link yükü ile birlikte rules adlı bir alanı JSON dizisi olarak gönderin. JSON dizileri göndermek için application/json kullanmanız gerekir.

Örneğin:

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

API aracılığıyla coğrafi-yönlendirme oluşturma

Ülkeye göre yeniden yönlendirmek için, yukarıdaki link yükü ile birlikte rules adlı bir alanı JSON dizisi olarak gönderin. JSON dizileri göndermek için application/json kodlaması kullanmanız gerekir.

Örneğin:

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

Ülke, iki karakterli ISO 3166 ülke kodudur.

API aracılığıyla cihaz yönlendirmesi oluşturma

Cihaza göre yeniden yönlendirmek için, yukarıdaki link yükü ile birlikte rules adlı bir alanı JSON dizisi olarak gönderin.

Örneğin:

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

Burada matches alanı aşağıdakilerden biridir:

• ios
• android
• windows
• linux
• mac

Tek bir istekte birden fazla linki oluşturma veya güncelleme

Linkly, istek başına 1000'e kadar linkin oluşturulmasını/değiştirilmesini destekler.

Bunu yapmak için, API anahtarınızı aşağıdaki gibi isteğin parçası olarak gönderin:

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

Ardından, bireysel link durumları için yukarıdakiyle aynı şemayı kullanın, ancak link isteklerini şu şekilde bir diziye sarın:

[{link}, {link}]

İki linki güncelleyecek tam bir istek aşağıda verilmiştir:

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/links?api_key=API_KEY'

Bu, hem oluşturma hem de güncelleme işlemleri için geçerlidir.

Lütfen dikkat edin ki, büyük bir istek için 60 saniye kadar sürebilir. İstekler bundan daha uzun sürerse, başarısız olacak ve iş yükünüzü daha küçük parçalara bölmeyi düşünmelisiniz.

Hız limitleri

Link kısaltma API'si saniye başına 20 istekle sınırlandırılmıştır. Saniye başına 200 istekeye kadar talep üzerine mevcuttur. Tek bir istekte 1000'e kadar link yükleyebilirsiniz.

İlgili

• Analytics API - Tıklama verilerini ve trafik raporlarını dışa aktarın
• Webhooks - Gerçek zamanlı tıklama bildirileri
• Zapier Entegrasyonu - Kod-gerektirmez entegrasyonlar