Tài liệu API

GET/api/me

Số dư, mã nạp tiền, mức giảm giá và bậc giảm giá.

curl https://ryuproxy.com/api/me \
  -H "X-API-Key: KHOA_CUA_BAN"

{"id": 12, "name": "Nguyễn Văn A", "email": "[email protected]", "kind": "reseller",
 "balance": 1500000, "pay_code": "RYU12", "discount_pct": 10,
 "proxies_live": 35, "tiers": [[10, 5], [30, 10], [100, 15]]}

tiers: mỗi phần tử là [số proxy tối thiểu, % giảm].

GET/api/plans

Các gói đang bán. price là giá sau giảm của riêng bạn, cho một proxy.

curl https://ryuproxy.com/api/plans \
  -H "X-API-Key: KHOA_CUA_BAN"

[{"id": 1, "kind": "period", "days": 1, "gb": null, "label": "1 ngày", "list_price": 15000, "price": 13500},
 {"id": 2, "kind": "period", "days": 30, "gb": null, "label": "30 ngày", "list_price": 300000, "price": 270000}]

Không cần khoá: GET /api/plans-public trả giá niêm yết.

GET/api/stock

Số proxy còn có thể mua ngay.

curl https://ryuproxy.com/api/stock -H "X-API-Key: KHOA_CUA_BAN"

{"free": 120}

GET/api/wallet

Số dư và các giao dịch gần đây. kind: topup nạp, charge trừ tiền, refund hoàn, adjust điều chỉnh.

curl https://ryuproxy.com/api/wallet -H "X-API-Key: KHOA_CUA_BAN"

{"customer": {...}, "balance": 1500000,
 "ledger": [{"id": 88, "amount": 2000000, "kind": "topup", "note": "Chuyển khoản",
             "balance_after": 2000000, "created": "2026-10-24T09:12:00+07:00"}]}

POST/api/allocate

Mua proxy, trừ tiền vào số dư. Số ngày theo gói (vd 1, 7, 30) hoặc bội số.

curl -X POST https://ryuproxy.com/api/allocate \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"days": 30, "quantity": 5, "proto": "http", "os": "auto"}'

{"order_id": 501, "proxies": [ {...}, ... ], "total": 1350000, "balance": 150000}

402: không đủ tiền. 409: không đủ proxy trống hoặc không có gói khớp số ngày.

GET/api/list

Proxy đang dùng. Thêm ?all=1 để lấy cả proxy đã hết hạn, ?order=<order_id> để lọc theo đơn.

curl "https://ryuproxy.com/api/list?order=501" -H "X-API-Key: KHOA_CUA_BAN"

Trả về mảng proxy.

POST/api/extend

Gia hạn thêm số ngày, giữ nguyên thông tin kết nối.

curl -X POST https://ryuproxy.com/api/extend \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"id": 3001, "days": 30}'

{"ok": true, "id": 3001, "expires": "2026-12-23T10:00:00+07:00"}

POST/api/rotate

Đổi IP ngay. Tối đa 6 lần mỗi giờ cho một proxy; quá mức trả 429.

curl -X POST https://ryuproxy.com/api/rotate \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"id": 3001}'

{"ok": true}

POST/api/set-rotate

Tự đổi IP theo lịch. every_min: 10–1440 phút, 0 để tắt.

curl -X POST https://ryuproxy.com/api/set-rotate \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"id": 3001, "every_min": 30}'

POST/api/set-proto

Đổi giữa http và socks5.

curl -X POST https://ryuproxy.com/api/set-proto \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"id": 3001, "proto": "socks5"}'

POST/api/set-os

Đổi máy giả lập: auto, win10, macos, android.

curl -X POST https://ryuproxy.com/api/set-os \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"id": 3001, "os": "android"}'

POST/api/set-auth

Đổi user và mật khẩu của proxy: 4–32 ký tự, chỉ chữ và số.

curl -X POST https://ryuproxy.com/api/set-auth \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"id": 3001, "user": "shop01", "pass": "Matkhau2026"}'

POST/api/release

Trả proxy trước hạn. Proxy ngừng hoạt động ngay.

curl -X POST https://ryuproxy.com/api/release \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"id": 3001}'

GET/api/keys · POST/api/keys/new · POST/api/keys/revoke

Quản lý khoá API. Khoá mới chỉ trả về đầy đủ một lần.

curl https://ryuproxy.com/api/keys -H "X-API-Key: KHOA_CUA_BAN"
# [{"key_tail": "a1b2", "label": "Máy chủ đại lý", "created": "2026-10-20T08:00:00+07:00"}]

curl -X POST https://ryuproxy.com/api/keys/new \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"label": "Phần mềm nuôi nick"}'
# {"key": "…"}

curl -X POST https://ryuproxy.com/api/keys/revoke \
  -H "X-API-Key: KHOA_CUA_BAN" -H "Content-Type: application/json" \
  -d '{"key_tail": "a1b2"}'

Cấu trúc một proxy

{"id": 3001, "endpoint": "vn1.ryuproxy.com:20001", "host": "vn1.ryuproxy.com", "port": 20001,
 "proto": "http", "user": "u3001", "pass": "abc123", "os": "auto",
 "state": "active", "ip": "113.185.x.x", "isp": "Viettel",
 "expires": "2026-11-23T10:00:00+07:00", "plan": "30 ngày", "price_paid": 270000,
 "order_id": 501, "rotate_every_min": 0, "used_bytes": 0, "quota_bytes": 0,
 "health": {"ok": true, "checked": "…", "exit_ip": "113.185.x.x", "lat_ms": 42, "fails": 0, "migrated": false}}

Chuỗi kết nối thường dùng: host:port:user:pass.