Developer docs · v1

Vượt link, bằng một request.

API REST của VuotLink giúp bạn gửi một URL và nhận về URL đích sau khi hoàn tất workflow.

Quick start

Gọi API trong 30 giây

POST /api/v1/bypass

cURL

curl -X POST /api/v1/bypass \
  -H "Content-Type: application/json" \
  -H "x-api-key: vl_live_xxx.secret" \
  -d '{
    "url": "https://linkvertise.com/...",
    "auto_solve_captcha": false,
    "max_hops": 10
  }'

01 · Authentication

Xác thực bằng API key

Tạo key trong Cài đặt → API keys. Gửi toàn bộ key trong header x-api-key. Key chỉ hiển thị một lần khi tạo.

Bảo mật: Không đặt API key trong frontend hoặc repository công khai.

02 · Request

Request body

application/json

{
  "url": "https://linkvertise.com/...",
  "auto_solve_captcha": false,
  "max_hops": 10
}

Field	Type	Bắt buộc	Mô tả
url	string	Có	URL HTTP/HTTPS public cần vượt.
auto_solve_captcha	boolean	Không	Solver captcha tự động, mặc định false.
max_hops	integer	Không	Tối đa workflow liên tiếp, mặc định 10.

03 · Response

Response thành công

200 OK · application/json

{
  "requested_url": "https://linkvertise.com/...",
  "final_url": "https://example.com/destination",
  "status_code": 200,
  "title": "Example destination",
  "workflow": "linkvertise",
  "hops_used": 1,
  "hops_exceeded": false,
  "solved_workflows": [
    {
      "workflow": "linkvertise",
      "resolved_url": "https://example.com/destination"
    }
  ],
  "total_cost": 200,
  "remaining_balance": 9800
}

URL qua nhiều dịch vụ sẽ được xử lý theo từng hop.

04 · Errors

Mã lỗi cần xử lý

401

API key không hợp lệ

Key thiếu, sai hoặc đã bị thu hồi.

402

Không đủ số dư

Nạp thêm xu trước khi gọi workflow.

403

Tài khoản bị khóa

API key chưa liên kết tài khoản active.

502

Workflow thất bại

Yêu cầu được hoàn phí tự động.