API Rút Gọn Liên Kết của Linkly

Tạo, cập nhật và quản lý liên kết theo lập trình bằng API Rút Gọn Liên Kết của Linkly.

Liên quan: API Phân Tích | Webhooks

Trước khi bạn bắt đầu

Linkly tạo các yêu cầu API trong giao diện để bạn sao chép và dán vào ứng dụng của mình.

Điều này hoạt động để tạo liên kết và cập nhật liên kết.

Tiết kiệm thời gian và để chúng tôi làm công việc khó:

1. 1
   Xem dưới đây để tạo yêu cầu API liên kết.
2. 2
   Sao chép các yêu cầu hoàn toàn. Bạn có thể xác minh chúng hoạt động cho bạn.
3. 3
   Hỏi ChatGPT hoặc tương đương để điều chỉnh các yêu cầu này thành mã nguồn cho ứng dụng của bạn. Không cần phải dành thời gian thực hiện tích hợp phức tạp. API của chúng tôi hoàn toàn có thể được máy sử dụng.

---

Thông số kỹ thuật OpenAPI 3.0

Bạn có thể tạo các yêu cầu API trực tiếp từ giao diện người dùng Linkly.

API của Linkly được ghi chép bằng tiêu chuẩn OpenAPI, vượt ra ngoài những gì được cung cấp dưới đây. Các điểm cuối giống nhau cũng có sẵn dưới dạng bộ sưu tập Postman chỉ cần một clic.

Xem Thông Số Kỹ Thuật OpenAPI

Chạy trong Postman

Ủy Quyền

Bạn sẽ cần:

• Khóa API của bạn
• ID Không Gian Làm Việc

Bạn có thể lấy các chi tiết này từ bên trong Linkly.

1. 1
   Đăng nhập vào Linkly.
2. 2
   Nhấp vào Cài đặt.
3. 3
   Nhấp vào Khóa API.

Tạo hoặc cập nhật liên kết

Để tạo liên kết, tất cả những gì bạn cần làm là gửi yêu cầu POST tới:

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

với các trường sau trong phần nội dung.

Loại mã hóa là x-www-form-urlencoded hoặc application/json.

Nếu bạn đang gửi trường Rules, bạn phải sử dụng application/json.

Chúng tôi khuyên bạn nên sử dụng JSON với thông số kỹ thuật Open API.

Ví dụ yêu cầu sử dụng curl

Mã dưới đây minh họa cách thực hiện yêu cầu API để tạo liên kết.

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'

Một phản hồi thành công sẽ trả về một đối tượng JSON đại diện cho liên kết, cùng với một id liên kết.

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

Cập nhật liên kết

Để cập nhật liên kết, gửi cùng yêu cầu bạn sử dụng để tạo liên kết, nhưng bao gồm trường id cho liên kết bạn muốn cập nhật, cũng như những thay đổi.

Tạo rotators thông qua API

Để tạo rotator, gửi trường gọi là rules dưới dạng mảng JSON, cùng với tải trọng liên kết ở trên. Bạn phải sử dụng application/json để gửi mảng JSON.

Ví dụ:

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

Tạo geo-redirects thông qua API

Để chuyển hướng theo quốc gia, gửi trường gọi là rules dưới dạng mảng JSON, cùng với tải trọng liên kết ở trên. Bạn phải sử dụng mã hóa application/json để gửi mảng JSON.

Ví dụ:

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

Quốc gia là mã quốc gia ISO 3166 alpha-2.

Tạo device redirects thông qua API

Để chuyển hướng theo thiết bị, gửi trường gọi là rules dưới dạng mảng JSON, cùng với tải trọng liên kết ở trên.

Ví dụ:

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

Khi trường matches là một trong những mục sau:

• ios
• android
• windows
• linux
• mac

Tạo hoặc cập nhật nhiều liên kết trong một yêu cầu

Linkly hỗ trợ tạo/sửa đổi tối đa 1000 liên kết cho mỗi yêu cầu.

Để làm như vậy, gửi khóa API của bạn như một phần của yêu cầu như sau:

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

Sau đó, sử dụng cùng một lược đồ như trên cho các trường hợp liên kết riêng lẻ, nhưng bao bọc các yêu cầu liên kết trong một mảng, của hình thức:

[{link}, {link}]

Đây là một yêu cầu hoàn chỉnh sẽ cập nhật hai liên kết:

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'

Điều này hoạt động cho cả hành động tạo và cập nhật.

Vui lòng lưu ý rằng có thể mất tới 60 giây để có yêu cầu lớn. Nếu yêu cầu mất thời gian lâu hơn so với điều này, chúng sẽ thất bại và bạn nên xem xét chia khối lượng công việc của mình thành các phần nhỏ hơn.

Giới Hạn Tỷ Lệ

API rút gọn liên kết được giới hạn ở 20 yêu cầu/giây. Tối đa 200 yêu cầu/giây có sẵn khi được yêu cầu. Bạn có thể tải lên tối đa 1000 liên kết trong một yêu cầu duy nhất.

Liên Quan

• API Phân Tích - Xuất dữ liệu nhấp chuột và báo cáo lưu lượng truy cập
• Webhooks - Thông báo nhấp chuột theo thời gian thực
• Tích Hợp Zapier - Tích hợp không cần mã