SHORT URL

API Shurlvn Là Gì? Hướng Dẫn Lấy Token Và Gọi API Rút Gọn Link Tự Động

Cập nhật: 2026-09-21

Muốn tự động rút gọn hàng loạt link từ hệ thống của bạn (CMS, CRM, bot Telegram...) mà không cần vào tay trang Shurlvn.com? Đó là lúc dùng API. Bài viết này hướng dẫn từ bước lấy API token đến gọi request đầu tiên.

API dùng để làm gì?

• Tự động rút gọn link ngay trong hệ thống của bạn (website, app, bot) mà không cần thao tác thủ công.
• Lấy danh sách link và số liệu thống kê để hiển thị trên dashboard nội bộ của riêng bạn.
• Kết hợp với các nền tảng tự động hoá như Zapier, Make, n8n.

Bước 1: Lấy API Token

Vào mục API (yêu cầu gói Pro trở lên), bấm nút tạo token:

Token hiển thị ngay sau khi tạo — giữ bí mật, ai có token này có thể tạo link nhân danh tài khoản bạn

Bước 2: Gọi API rút gọn link đầu tiên

Dùng token vừa lấy trong header Authorization:

curl -X POST https://shurlvn.com/api/v1/shorten \
  -H "Authorization: Bearer SHURL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

Nếu URL đích có ký tự đặc biệt hoặc dấu tiếng Việt, hãy dùng công cụ URL Encoder để mã hoá phần giá trị trước khi đưa vào JSON body.

Các endpoint chính khác

Hạn mức request theo gói

Vượt hạn mức, API trả lỗi báo hết hạn mức tháng — hạn mức tự reset vào đầu tháng sau. Bấm "Tạo lại Token" bất cứ lúc nào để vô hiệu hoá token cũ (hữu ích nếu nghi ngờ token bị lộ).

💡 Mẹo: Không cần code cũng dùng được API — kết hợp với Zapier/Make bằng khối "Webhooks" hoặc "HTTP Request" để tự động rút gọn link mỗi khi có dòng mới trong Google Sheet, hoặc mỗi khi có bài đăng mới từ CMS.

Tổng kết

• API cho phép tự động hoá việc tạo link, lấy thống kê, quản lý webhook mà không cần thao tác tay
• Cần tạo API Token từ mục API (gói Pro trở lên) và gửi kèm mọi request qua header Authorization
• Hạn mức 5.000-10.000 request/tháng tuỳ gói, reset đầu mỗi tháng