API Pemendekan Tautan Linkly

Buat, perbarui, dan kelola tautan secara programatik menggunakan API Pemendekan Tautan Linkly.

Terkait: Analytics API | Webhooks

Sebelum Anda mulai

Linkly menghasilkan permintaan API di antarmuka untuk Anda salin & tempel ke dalam aplikasi Anda.

Ini berfungsi untuk pembuatan tautan dan pembaruan tautan.

Hemat waktu dan biarkan kami melakukan pekerjaan berat:

1. 1
   Lihat di bawah untuk permintaan API pembuatan tautan.
2. 2
   Salin permintaan secara keseluruhan. Anda dapat memverifikasi bahwa mereka berfungsi untuk Anda.
3. 3
   Minta ChatGPT atau yang setara untuk menyesuaikan permintaan ini menjadi kode sumber untuk aplikasi Anda. Tidak perlu menghabiskan waktu untuk integrasi yang kompleks. API kami sepenuhnya dapat dikonsumsi mesin.

---

Spesifikasi OpenAPI 3.0

Anda dapat menghasilkan permintaan API langsung dari antarmuka pengguna Linkly.

API Linkly didokumentasikan menggunakan standar OpenAPI, yang melampaui apa yang disediakan di bawah. Endpoint yang sama juga tersedia sebagai koleksi Postman satu klik.

Lihat Spesifikasi OpenAPI

Jalankan di Postman

Otorisasi

Anda akan memerlukan:

• Kunci API Anda
• ID Ruang Kerja

Anda dapat mendapatkan detail ini dari dalam Linkly.

1. 1
   Login ke Linkly.
2. 2
   Klik Pengaturan.
3. 3
   Klik Kunci API.

Membuat atau memperbarui tautan

Untuk membuat tautan, yang perlu Anda lakukan adalah mengirim permintaan POST ke:

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

dengan bidang berikut di badan permintaan.

Jenis pengkodean adalah x-www-form-urlencoded atau application/json.

Jika Anda mengirimkan bidang Rules, Anda harus menggunakan application/json.

Kami merekomendasikan Anda menggunakan JSON dengan spesifikasi Open API.

Contoh permintaan menggunakan curl

Kode di bawah mengilustrasikan cara membuat permintaan API untuk membuat tautan.

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'

Respons yang berhasil akan mengembalikan objek JSON yang mewakili tautan, bersama dengan id tautan.

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

Memperbarui tautan

Untuk memperbarui tautan, kirim permintaan yang sama yang Anda gunakan untuk membuat tautan, tetapi sertakan bidang id untuk tautan yang ingin Anda perbarui, serta perubahannya.

Membuat rotator melalui API

Untuk membuat rotator, kirimkan bidang yang disebut rules sebagai array JSON, bersama dengan payload tautan di atas. Anda harus menggunakan application/json untuk mengirim array JSON.

Misalnya:

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

Membuat pengalihan geo melalui API

Untuk mengalihkan berdasarkan negara, kirimkan bidang yang disebut rules sebagai array JSON, bersama dengan payload tautan di atas. Anda harus menggunakan pengkodean application/json untuk mengirim array JSON.

Misalnya:

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

Negara adalah kode negara ISO 3166 alfa-2.

Membuat pengalihan perangkat melalui API

Untuk mengalihkan berdasarkan perangkat, kirimkan bidang yang disebut rules sebagai array JSON, bersama dengan payload tautan di atas.

Misalnya:

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

Di mana bidang matches adalah salah satu dari:

• ios
• android
• windows
• linux
• mac

Membuat atau memperbarui beberapa tautan dalam satu permintaan

Linkly mendukung pembuatan/perubahan hingga 1000 tautan per permintaan.

Untuk melakukannya, kirimkan kunci API Anda sebagai bagian dari permintaan sebagai berikut:

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

Kemudian, gunakan skema yang sama dengan kasus tautan individual di atas, tetapi bungkus permintaan tautan dalam array, dengan bentuk:

[{link}, {link}]

Berikut adalah permintaan lengkap yang akan memperbarui dua tautan:

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'

Ini berfungsi untuk tindakan pembuatan dan pembaruan.

Harap dicatat bahwa dapat memakan waktu hingga 60 detik untuk permintaan besar. Jika permintaan memakan waktu lebih lama dari ini, permintaan akan gagal, dan Anda harus mempertimbangkan untuk membagi beban kerja Anda menjadi potongan yang lebih kecil.

Batas Laju

API pemendekan tautan dibatasi hingga 20 permintaan/detik. Hingga 200 permintaan per detik tersedia atas permintaan. Anda dapat mengunggah hingga 1000 tautan dalam satu permintaan.

Terkait

• Analytics API - Ekspor data klik dan laporan lalu lintas
• Webhooks - Notifikasi klik real-time
• Integrasi Zapier - Integrasi tanpa kode