Tài liệu · bito.li

Tham chiếu API Endpoint, tham số, cấu trúc response, mã lỗi và giới hạn tần suất, kèm bảng “Chạy thử” gọi API thật. Xem tham chiếu Hướng dẫn sử dụng Cách tạo link, đặt mật khẩu và hạn dùng, xem thống kê, dùng mã QR, trang bio và dashboard. Mở hướng dẫn

Bắt đầu nhanh

Rút gọn link đầu tiên chỉ với một request. Response có link rút gọn và secret code để quản lý link về sau.

1
Gửi request

POST URL đích tới /api/links dưới dạng JSON. Không cần xác thực.
2
Giữ secret code

secretCode trong response chỉ hiện một lần. Lưu lại để xem thống kê, sửa hoặc xoá link.
3
Chia sẻ link rút gọn

Dùng shortUrl ở bất cứ đâu. Lượt click hiện trên trang thống kê tại statsUrl.

curl -X POST 'https://bito.li/api/links' \
  -H 'Content-Type: application/json' \
  -d '{
  "originalUrl": "https://example.com/spring-sale?utm_source=newsletter"
}'

Response · 201

{
  "originalUrl": "https://example.com/spring-sale?utm_source=newsletter",
  "shortUrl": "https://bito.li/Xk3b9",
  "shortCode": "Xk3b9",
  "statsUrl": "https://bito.li/d/Xk3b9",
  "clicks": 0,
  "expiresAt": null,
  "maxClicks": null,
  "controlMode": "full",
  "secretCode": "s-3f9-a1c-07b",
  "password": null,
  "userId": null
}

Khái niệm chính

Chế độ quản lý Chọn link có được quản lý và theo dõi hay không: full, statsOnly hoặc none. Secret code Khoá riêng của từng link, dạng s-xxx-xxx-xxx, thay cho tài khoản với link đó. Lỗi Mỗi lỗi có errorKey cố định để code xử lý, kèm thông báo dễ đọc. Giới hạn tần suất 120 lần tạo mỗi 10 phút và trần theo ngày cho mỗi địa chỉ IP.

Chủ đề phổ biến

Cần hỗ trợ?

Có chỗ chưa rõ hoặc API chạy khác với tài liệu? Gửi email tới [email protected], kèm request bạn đã gửi và errorKey nhận được.

Làm việc với bito.li

Bắt đầu nhanh

Khái niệm chính

Chủ đề phổ biến