Gozi.to

API

Tạo và quản lý liên kết rút gọn từ script và ứng dụng. API miễn phí. Tạo một khoá trong bảng điều khiển ở mục Khoá API, rồi gửi kèm dưới dạng bearer token.

Xác thực

Authorization: Bearer gz_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Khoá chỉ hiện một lần. Hãy coi chúng như mật khẩu: ai có khoá của bạn cũng có thể tạo và sửa liên kết trong tài khoản của bạn. Thu hồi khoá bị lộ ngay trong bảng điều khiển.

Giới hạn

Tạo một liên kết

curl -X POST https://gozi.to/api/my/links \
  -H "Authorization: Bearer $GOZI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/launch", "code": "launch"}'

code là tuỳ chọn (4–32 chữ cái, chữ số, - hoặc _). Bỏ trống để nhận một mã ngẫu nhiên 7 ký tự. Phản hồi 201:

{
  "link": {
    "code": "launch",
    "shortUrl": "https://gozi.to/launch",
    "url": "https://example.com/launch",
    "status": "active",
    "statusReason": null,
    "custom": true,
    "createdAt": 1790000000000,
    "expiresAt": null
  }
}

Liệt kê liên kết

GET /api/my/links?limit=25&cursor=<nextCursor>&q=<search>&clicks=1

Mới nhất trước. Truyền nextCursor của trang trước để lấy trang tiếp theo. clicks=1 thêm tổng số lượt nhấp của người thật từ trước đến nay.

Lấy, sửa, xoá

GET    /api/my/links/{code}
PATCH  /api/my/links/{code}   {"url": "https://new.example"}  or  {"status": "disabled" | "active"}
DELETE /api/my/links/{code}

Phân tích

GET /api/my/links/{code}/stats

Trả về lượt nhấp của người thật trong 90 ngày gần nhất và từ trước đến nay, lượt nhấp mỗi ngày, cùng các quốc gia, nguồn dẫn đến, thiết bị, trình duyệt và hệ điều hành hàng đầu. Bot và bản xem trước liên kết (Slack, WhatsApp, v.v.) được đếm riêng trong botClicks. Kết quả được lưu đệm khoảng 5 phút.

Lỗi

Lỗi dùng mã trạng thái HTTP và một nội dung JSON:

{ "error": { "code": "slug_taken", "message": "That custom link is already taken." } }

Bản mô tả máy đọc được của mọi endpoint nằm tại /openapi.json.