Developer API

Tài liệu API chuyển đổi link

API dùng key/token riêng của từng thành viên, có rate limit và log chống lạm dụng. Không đặt API token trong JavaScript public.

Đăng nhập để lấy API key

Endpoint

POST https://shpee.fun/api/convert

API này dành cho server-to-server. Không nhúng api_token vào frontend, extension, landing page hoặc mã JavaScript public.

Cách gửi thông tin xác thực khuyến nghị

X-API-Key: sk_xxxxxX-API-Token: tok_xxxxx

Vẫn hỗ trợ truyền api_key và api_token trong JSON body để tương thích, nhưng header an toàn và gọn hơn.

Body JSON

{
  "content": "Nội dung có link Shopee cần chuyển",
  "affiliate_id": "AFFILIATE_ID_CUA_BAN",
  "sub_ids": ["facebook", "group-a"],
  "mode": "affiliate"
}

Các mode hợp lệ

Mode	Ý nghĩa
`affiliate`	Link aff shopee
`own_shortener`	Rút gọn với shpee.fun
`custom_domain_shortener`	Rút gọn với tên miền riêng (Pro)
`shopee_api`	Shopee API
`link_goc`	Link gốc Shopee
`isgd`	Rút gọn is.gd
`vgd`	Rút gọn v.gd
`tinyurl`	Rút gọn TinyURL
`bitly`	Rút gọn Bitly
`byvn`	Rút gọn By.com.vn

Ví dụ cURL

curl -X POST "https://shpee.fun/api/convert" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Token: YOUR_API_TOKEN" \
  -d '{
    "content":"https://shopee.vn/...",
    "affiliate_id":"YOUR_AFFILIATE_ID",
    "mode":"affiliate"
  }'

Response mẫu

{
  "ok": true,
  "message": "Tạo thành công 10/12 link, 2 link chưa chuyển được.",
  "mode": "Link aff Shopee",
  "output": "Nội dung sau khi chuyển",
  "summary": {"total": 12, "success": 10, "failed": 2},
  "items": []
}

Giới hạn và bảo mật

Mỗi API key và mỗi user đều có giới hạn request theo phút để chống clone/lạm dụng.
Request sai key/token nhiều lần có thể bị chặn IP tự động.
Response không trả về token, cấu hình nội bộ hoặc thông tin debug của server.
Có thể đổi API key/token trong mục Tài khoản nếu nghi ngờ bị lộ.