Tài liệu tham khảo FlashProxy API

Kiểm tra số dư và gói của bạn, đọc mức sử dụng, tạo proxy và mở rộng gói từ các tập lệnh của riêng bạn. Mỗi endpoint trả về JSON và chỉ đọc dữ liệu từ tài khoản của bạn.

URL cơ sở: https://www.flashproxy.com

Tạo khóa API trong bảng điều khiển của bạn tại https://www.flashproxy.com/dashboard/api. Khóa đầy đủ chỉ được hiển thị một lần, vì vậy hãy lưu trữ nó một cách an toàn.

Đang sử dụng một AI agent? Hãy cung cấp cho nó toàn bộ tài liệu tham khảo này dưới dạng một tệp Markdown: https://www.flashproxy.com/api-reference.md. Thông số kỹ thuật OpenAPI 3,1 có tại https://www.flashproxy.com/openapi.json.

Bắt đầu nhanh

Liệt kê gói của bạn, sau đó sử dụng plan_id từ câu trả lời trong các endpoint khác.

cURL

curl "https://www.flashproxy.com/api/v1/plans?status=active&limit=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Python

import requests

response = requests.get(
    "https://www.flashproxy.com/api/v1/plans?status=active&limit=10",
    headers={
        "Authorization": "Bearer fpk_live_YOUR_KEY",
    },
    timeout=30,
)
print(response.json())

Node.js

const response = await fetch("https://www.flashproxy.com/api/v1/plans?status=active&limit=10", {
  headers: {
    "Authorization": "Bearer fpk_live_YOUR_KEY",
  },
});
console.log(await response.json());

Xác thực

Gửi khóa của bạn trong header Authorization dưới dạng Bearer fpk_live_…, hoặc trong header X-API-Key.

Mỗi khóa có thể đọc cách sử dụng. Tạo proxy và mở rộng gói mỗi cái cần có quyền riêng của nó, mà bạn chọn khi tạo khóa. Xử lý khóa giống như mật khẩu và thu hồi nó nếu nó bị rò rỉ.

Quyền của khóa

Quyền	Cho phép
usage	Đọc dữ liệu đã sử dụng, dữ liệu còn lại và tốc độ hiện tại. Mọi khóa đều có nó.
proxies	Tạo danh sách proxy. Phản hồi chứa tên người dùng và mật khẩu proxy của bạn.
extend	Mở rộng các gói dịch vụ. Mỗi lệnh gọi được thanh toán từ số dư tài khoản của bạn.

Tài khoản

Khóa hiện tại

GET /api/v1/key

Trả về khóa mà bạn đang gọi: tên, tiền tố và quyền của nó. Hữu ích khi một lệnh gọi trả lời 403 FORBIDDEN.

Quyền: usage

Yêu cầu

curl "https://www.flashproxy.com/api/v1/key" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "key_id": "7d1c2b4e-…",
    "name": "Monitoring server",
    "key_prefix": "fpk_live_k3x9q2ma",
    "permissions": [
      "usage",
      "proxies",
      "extend"
    ],
    "created_at": "2026-09-29T12:00:00.000Z",
    "last_used_at": "2026-10-13T12:00:00.000Z"
  }
}

Số dư tài khoản

GET /api/v1/balance

Trả về số dư tài khoản khả dụng của bạn, tiền được sử dụng để thanh toán cho các lần mở rộng.

Quyền: usage

Yêu cầu

curl "https://www.flashproxy.com/api/v1/balance" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "balance_usd": 42.18,
    "balance_cents": 4218,
    "currency": "USD"
  }
}

Liệt kê các gói

GET /api/v1/plans

Trả về các gói của bạn, mới nhất trước, với trạng thái, ngày hết hạn, giới hạn dữ liệu và liệu chúng được mở rộng theo GB hay ngày. Không bao giờ trả về thông tin xác thực proxy.

Quyền: usage

Các tham số

Tên	Trong	Mô tả
status	query	all (mặc định), active hoặc expired.
limit	query	Bao nhiêu gói để trả về, tối đa 100. Mặc định là 50.
offset	query	Bao nhiêu gói để bỏ qua, để phân trang. Mặc định là 0.

Yêu cầu

curl "https://www.flashproxy.com/api/v1/plans?status=active&limit=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "plans": [
      {
        "plan_id": "YOUR_PLAN_ID",
        "product": "residential",
        "name": "Residential Proxies",
        "status": "active",
        "billed_by": "data",
        "created_at": "2026-09-13T12:00:00.000Z",
        "expires_at": "2027-03-12T12:00:00.000Z",
        "max_bytes": 10737418240,
        "bytes_used": 4294967296,
        "speed_mbps": null,
        "extend_with": "gb"
      }
    ],
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

Danh sách giao dịch

GET /api/v1/transactions

Trả về các khoản thanh toán, nạp tiền và mua saldo của bạn, mới nhất trước, để ghi sổ.

Quyền: usage

Các tham số

Tên	Trong	Bắt buộc	Mô tả
limit	query		Bao nhiêu giao dịch để trả về, tối đa 100. Mặc định là 50.
offset	query		Bao nhiêu giao dịch để bỏ qua, để phân trang. Mặc định là 0.

Yêu cầu

curl "https://www.flashproxy.com/api/v1/transactions?limit=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "transactions": [
      {
        "transaction_id": "FP-1791900000000-a1b2c3d4e",
        "type": "PURCHASE",
        "status": "COMPLETED",
        "amount_usd": 29.8,
        "payment_method": "BALANCE",
        "description": "Purchase of 1 item",
        "created_at": "2026-10-11T12:00:00.000Z",
        "completed_at": "2026-10-11T12:00:00.000Z"
      }
    ],
    "total": 1,
    "limit": 10,
    "offset": 0,
    "currency": "USD"
  }
}
```,## Sử dụng

### Sử dụng của tất cả các gói hoạt động

`GET /api/v1/usage`

Trả về một bản ghi sử dụng cho mỗi gói hoạt động trên tài khoản của bạn.

Quyền: `usage`

**Yêu cầu**

```bash
curl "https://www.flashproxy.com/api/v1/usage" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "plans": [
      {
        "plan_id": "YOUR_PLAN_ID",
        "product": "ipv6-datacenter",
        "name": "IPv6 Datacenter Proxies",
        "status": "active",
        "expires_at": "2026-11-01T12:00:00.000Z",
        "usage": {
          "bytes_used": 2639963,
          "max_bytes": null,
          "remaining_bytes": null,
          "percentage_used": null
        },
        "throughput_status": "ok",
        "throughput": {
          "source": "per_minute",
          "current_mbps": 412.5,
          "avg_mbps_5m": 380.1,
          "peak_mbps_1h": 955,
          "sampled_at": "2026-10-13T11:59:15.000Z",
          "data_delay_seconds": 45,
          "limit_mbps": 1000,
          "utilization_pct": 41.25
        },
        "generated_at": "2026-10-13T12:00:00.000Z"
      }
    ]
  }
}

Sử dụng của một gói

GET /api/v1/plans/{plan_id}/usage

Trả về bản ghi sử dụng của một trong các gói của bạn, bất kể trạng thái của nó.

Quyền: usage

Các tham số

Tên	Trong	Bắt buộc	Mô tả
plan_id	path	bắt buộc	ID gói, như được trả về trong plan_id bởi List plans.

Yêu cầu

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/usage" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "product": "ipv6-datacenter",
    "name": "IPv6 Datacenter Proxies",
    "status": "active",
    "expires_at": "2026-11-01T12:00:00.000Z",
    "usage": {
      "bytes_used": 2639963,
      "max_bytes": null,
      "remaining_bytes": null,
      "percentage_used": null
    },
    "throughput_status": "ok",
    "throughput": {
      "source": "per_minute",
      "current_mbps": 412.5,
      "avg_mbps_5m": 380.1,
      "peak_mbps_1h": 955,
      "sampled_at": "2026-10-13T11:59:15.000Z",
      "data_delay_seconds": 45,
      "limit_mbps": 1000,
      "utilization_pct": 41.25
    },
    "generated_at": "2026-10-13T12:00:00.000Z"
  }
}

Lịch sử sử dụng

GET /api/v1/plans/{plan_id}/usage/history

Trả về lưu lượng và tốc độ của một gói theo thời gian, trong các khoảng thời gian cố định (1 phút cho 1 giờ lên đến 4 giờ cho 30 ngày), với tổng cộng, tỷ lệ thành công và đỉnh cao. Dấu thời gian là UTC. Có sẵn cho các gói ISP, ISP EU, Datacenter, IPv6 và Premium Unlimited.

Quyền: usage

Các tham số

Tên	Trong	Bắt buộc	Mô tả
plan_id	path	bắt buộc	ID gói, như được trả về trong plan_id bởi List plans.
range	query		Cửa sổ thời gian: 1h, 24h, 7d, 30d. Mặc định là 24h.

Yêu cầu

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/usage/history?range=24h" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "range": "24h",
    "bucket_seconds": 900,
    "generated_at": "2026-10-13T12:00:00.000Z",
    "totals": {
      "bytes": 3221225472,
      "bytes_up": 214748364.8,
      "bytes_down": 3006477107.2,
      "connections": 48210,
      "success_pct": 99.2,
      "peak_mbps": 412.5,
      "peak_concurrent": 37
    },
    "series": [
      {
        "t": "2026-10-13T11:30:00.000Z",
        "bytes": 41943040,
        "bytes_up": 2097152,
        "bytes_down": 39845888,
        "mbps": 0.37,
        "connections_per_sec": 0.62,
        "concurrent": 12
      },
      {
        "t": "2026-10-13T11:45:00.000Z",
        "bytes": 52428800,
        "bytes_up": 3145728,
        "bytes_down": 49283072,
        "mbps": 0.47,
        "connections_per_sec": 0.71,
        "concurrent": 15
      }
    ]
  }
}

Điểm đến hàng đầu

GET /api/v1/plans/{plan_id}/destinations

Trả về các trang web mà gói được kết nối đến nhiều nhất trong khoảng thời gian, với lưu lượng, kết nối và tỷ lệ thành công cho mỗi máy chủ (top 100).

Quyền: usage

Các tham số

Tên	Trong	Bắt buộc	Mô tả
plan_id	path	bắt buộc	ID gói, như được trả về trong plan_id bởi List plans.
range	query		Cửa sổ thời gian: 1h, 24h, 7d, 30d. Mặc định là 24h.

Yêu cầu

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/destinations?range=24h" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "range": "24h",
    "generated_at": "2026-10-13T12:00:00.000Z",
    "destinations": [
      {
        "host": "example.com",
        "bytes_down": 1288490188.8,
        "bytes_up": 107374182.4,
        "connections": 18240,
        "failed": 96,
        "success_pct": 99.5
      }
    ]
  }
}

Phân tích lỗi

GET /api/v1/plans/{plan_id}/errors

Trả về những gì đã xảy ra sai trong khoảng thời gian, được nhóm theo danh mục, mỗi cái có một nhãn có thể đọc được và một gợi ý về những gì cần kiểm tra.

Quyền: usage

Các tham số

Tên	Trong	Bắt buộc	Mô tả
plan_id	path	bắt buộc	ID gói, như được trả về trong plan_id bởi List plans.
range	query		Cửa sổ thời gian: 1h, 24h, 7d, 30d. Mặc định là 24h.

Yêu cầu

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/errors?range=24h" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "range": "24h",
    "generated_at": "2026-10-13T12:00:00.000Z",
    "errors": [
      {
        "category": "timeout",
        "label": "Connection timed out",
        "hint": "The destination did not answer in time. Usually a slow or overloaded target site; retry with a longer client timeout, and check whether one destination dominates.",
        "count": 214
      }
    ]
  }
}
```,## Proxy

### Vị trí gói

`GET /api/v1/plans/{plan_id}/locations`

Trả về các quốc gia mà gói có thể nhắm tới với trường country khi bạn tạo proxy. Khi any_country là true, bất kỳ mã hai chữ cái nào cũng được chấp nhận và không có danh sách.

Quyền: `usage`

**Các tham số**

| Tên | Trong | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `plan_id` | path | bắt buộc | ID gói, như được trả về trong plan_id bởi List plans. |

**Yêu cầu**

```bash
curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/locations" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "product": "ipv6-datacenter",
    "any_country": false,
    "countries": [
      {
        "code": "CA",
        "name": "Canada"
      },
      {
        "code": "FR",
        "name": "France"
      },
      {
        "code": "US",
        "name": "United States"
      }
    ]
  }
}

Tạo proxy

POST /api/v1/plans/{plan_id}/proxies

Tạo các dòng proxy sẵn sàng sử dụng cho một trong những gói hoạt động của bạn, giống như cách trình tạo bảng điều khiển thực hiện.

Quyền: proxies

Các tham số

Tên	Trong	Bắt buộc	Mô tả
plan_id	path	bắt buộc	ID gói, như được trả về trong plan_id bởi List plans.
count	body		Bao nhiêu dòng để trả về, 1 đến 1000. Mặc định là 10.
country	body		Mã quốc gia hai chữ cái để nhắm mục tiêu, ví dụ US. Bỏ qua nó để sử dụng bất kỳ quốc gia nào.
session	body		rotating để lấy một IP mới trên mỗi yêu cầu (mặc định), hoặc sticky để giữ cùng một IP.
sticky_minutes	body		Thời gian một IP sticky được giữ, 1 đến 1000 phút. Residential và mobile giới hạn nó ở 120. Mặc định là 30.
protocol	body		http (mặc định) hoặc socks5.
format	body		hostport cho host:port:user:pass (mặc định), hoặc url cho scheme://user:pass@host:port.

Yêu cầu

curl -X POST "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/proxies" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":2,"country":"US","session":"sticky","sticky_minutes":30,"protocol":"http","format":"hostport"}'

Phản hồi · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "count": 2,
    "protocol": "http",
    "format": "hostport",
    "proxies": [
      "adam.flashproxy.io:8080:USERNAME-country-US-session-k3x9q2ma-time-30:PASSWORD",
      "adam.flashproxy.io:8080:USERNAME-country-US-session-p7d1v8tc-time-30:PASSWORD"
    ]
  }
}

Danh sách IP cố định

GET /api/v1/plans/{plan_id}/ips

Trả về các IP cố định của gói cùng với thông tin đăng nhập: IP thoát hoạt động cho các gói Datacenter, hoặc các IP được cho thuê cho các gói Dedicated ISP. Các gói rotating-gateway sử dụng Generate proxies thay thế.

Quyền: proxies

Các tham số

Tên	Trong	Bắt buộc	Mô tả
plan_id	path	bắt buộc	ID gói, như được trả về trong plan_id bởi List plans.
protocol	query		http (mặc định) hoặc socks5. Các gói Dedicated ISP v2 chỉ hỗ trợ http.
format	query		hostport cho host:port:user:pass (mặc định), hoặc url cho scheme://user:pass@host:port.
limit	query		Bao nhiêu IP để trả về, tối đa 10000. Mặc định là 1000. total luôn hiển thị số lượng đầy đủ.

Yêu cầu

curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/ips?protocol=http&limit=2" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "product": "datacenter",
    "source": "live",
    "protocol": "http",
    "format": "hostport",
    "total": 2048,
    "count": 2,
    "proxies": [
      "203.0.113.10:777:USERNAME:PASSWORD",
      "203.0.113.11:777:USERNAME:PASSWORD"
    ]
  }
}
```,## Phần mở rộng

### Báo giá mở rộng

`GET /api/v1/plans/{plan_id}/extend/quote`

Trả về chi phí của một mở rộng, chạy các kiểm tra giống như Extend a plan, mà không mua bất cứ điều gì.

Quyền: `usage`

**Các tham số**

| Tên | Trong | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `plan_id` | path | bắt buộc | ID gói, như được trả về trong plan_id bởi List plans. |
| `gb` | query |  | GB để báo giá, cho các gói được tính theo dữ liệu. |
| `days` | query |  | Ngày để báo giá, cho các gói được tính theo thời gian. Gửi gb hoặc days, không phải cả hai. |

**Yêu cầu**

```bash
curl "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/extend/quote?gb=10" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "added": {
      "gb": 10
    },
    "price_usd": 35,
    "currency": "USD"
  }
}

Mở rộng gói

POST /api/v1/plans/{plan_id}/extend

Thêm dữ liệu (GB) hoặc thời gian (ngày) vào một trong những gói của bạn và thanh toán từ số dư tài khoản của bạn, với mức giá tương tự như trên bảng điều khiển.

Quyền: extend

Các tham số

Tên	Trong	Bắt buộc	Mô tả
plan_id	path	bắt buộc	ID gói, như được trả về trong plan_id bởi List plans.
Idempotency-Key	header	bắt buộc	Một chuỗi duy nhất cho mở rộng này. Xem Idempotency bên dưới.
gb	body		GB để thêm, cho các gói được tính theo dữ liệu. Một số nguyên từ 1 đến 2.000.000.
days	body		Ngày để thêm, cho các gói được tính theo thời gian: 1 đến 365, hoặc 1, 7, 30, 60 cho Premium Unlimited Residential. Gửi gb hoặc days, không phải cả hai.

Yêu cầu

curl -X POST "https://www.flashproxy.com/api/v1/plans/YOUR_PLAN_ID/extend" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY" \
  -H "Idempotency-Key: extend-2026-10-13-001" \
  -H "Content-Type: application/json" \
  -d '{"gb":10}'

Phản hồi · 200

{
  "success": true,
  "data": {
    "plan_id": "YOUR_PLAN_ID",
    "charged_usd": 35,
    "added": {
      "gb": 10
    },
    "plan": {
      "status": "active",
      "expires_at": "2027-04-11T12:00:00.000Z",
      "max_bytes": 21474836480
    },
    "replayed": false
  }
}
```,## Sản phẩm & giá

### Sản phẩm và giá

`GET /api/v1/products`

Trả về mọi sản phẩm với các tầng theo GB (toàn bộ số tiền được tính theo tỷ giá của tầng mà nó rơi vào) và giá về tốc độ và ngày. Sử dụng Quote an extension để xem giá chính xác của một gói cụ thể.

Quyền: `usage`

**Yêu cầu**

```bash
curl "https://www.flashproxy.com/api/v1/products" \
  -H "Authorization: Bearer fpk_live_YOUR_KEY"

Phản hồi · 200

{
  "success": true,
  "data": {
    "products": [
      {
        "product": "datacenter",
        "name": "Datacenter Proxies",
        "billed_by": [
          "data",
          "time"
        ],
        "data_pricing": [
          {
            "up_to_gb": 1,
            "per_gb_usd": 0.7
          },
          {
            "up_to_gb": 5,
            "per_gb_usd": 0.65
          }
        ],
        "time_pricing": [
          {
            "mbps": 10,
            "days": 1,
            "price_usd": 1
          },
          {
            "mbps": 10,
            "days": 30,
            "price_usd": 18
          }
        ]
      }
    ],
    "currency": "USD"
  }
}

Idempotency

Mở rộng một gói sẽ tiêu tốn số dư của bạn, vì vậy mỗi lệnh gọi mở rộng cần một header Idempotency-Key.

Sử dụng một khóa mới cho mỗi lần mở rộng mà bạn muốn mua: 8 đến 128 chữ cái, chữ số, - hoặc _.
Nếu lệnh gọi hết thời gian chờ hoặc trả về lỗi 5xx, hãy gửi lại với cùng một khóa. Bạn sẽ được tính phí tối đa một lần, và một lần mở rộng hoàn tất sẽ trả lại replayed: true.
Khóa tương tự với một gói dịch vụ hoặc số tiền khác trả về 409 IDEMPOTENCY_KEY_REUSED.
Trong khi lệnh gọi đầu tiên vẫn đang chạy, lệnh gọi thứ hai có cùng khóa sẽ trả về 409 REQUEST_IN_PROGRESS.

Trường phản hồi

Mỗi gói trong phản hồi sử dụng mang theo cùng một bản ghi.

Trường	Ý nghĩa
usage.*	bytes_used, max_bytes, remaining_bytes và percentage_used. max_bytes và remaining_bytes là null trên các gói không có giới hạn dữ liệu. bytes_used là null trên Unlimited Residential, được tính theo thời gian và tốc độ.
throughput.current_mbps	Phép đo tốc độ mới nhất: phút hoàn chỉnh cuối cùng cho hầu hết các sản phẩm, 0 khi không có lưu lượng truy cập gần đây.
throughput.avg_mbps_5m / peak_mbps_1h	Tốc độ trung bình 5 phút và tốc độ đỉnh 1 giờ.
throughput.limit_mbps	Giới hạn tốc độ của gói của bạn. utilization_pct là tốc độ hiện tại chia cho giới hạn này.
throughput.sampled_at	Khi phép đo mới nhất được thực hiện. data_delay_seconds cho bạn biết nó cũ bao lâu.

Giá trị của throughput_status

Giá trị	Ý nghĩa
ok	throughput được điền đầy đủ.
pending	Tốc độ vẫn đang được thu thập. Đối với Unlimited Residential, lần đọc đầu tiên có thể mất tới 10 phút; tiếp tục thăm dò như bình thường.
unavailable	Tốc độ tạm thời không khả dụng. Thử lại sau.
not_supported	Sản phẩm này chưa có số liệu tốc độ. Các bộ đếm sử dụng vẫn hoạt động.

Giới hạn

60 yêu cầu mỗi phút trên mỗi khóa
Tất cả các khóa của một tài khoản chia sẻ giới hạn 120 yêu cầu mỗi phút.
Vượt quá giới hạn bạn nhận được 429 với tiêu đề Retry-After: 60.
Các lệnh gọi Extend cũng được tính vào giới hạn 6 lần mua số dư mỗi phút trên mỗi tài khoản, được chia sẻ với bảng điều khiển.
Tốc độ được đo mỗi phút, vì vậy thăm dò mỗi 15 đến 30 giây là đủ.
Câu trả lời mức sử dụng có thể cũ tới 15 giây và giá sản phẩm cũ tới 5 phút.

Lỗi

Các lỗi có cùng một cấu trúc: success là false và error chứa một mã và một thông báo có thể đọc được.

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

Trạng thái	Mã	Ý nghĩa
400	INVALID_REQUEST	Phần thân hoặc một tham số không hợp lệ. Thông báo cho biết cái nào.
400	IDEMPOTENCY_KEY_REQUIRED	Lệnh gọi extend mà không có tiêu đề Idempotency-Key hợp lệ.
400	PAYMENT_REFUSED	Thanh toán số dư bị từ chối. Liên hệ hỗ trợ.
401	UNAUTHORIZED	Khóa bị thiếu, không hợp lệ hoặc bị thu hồi.
402	INSUFFICIENT_BALANCE	Số dư của bạn quá thấp cho phần mở rộng này. Nạp tiền và thử lại.
403	FORBIDDEN	Khóa không có quyền cần thiết cho điểm cuối này.
404	NOT_FOUND	Không có gói như vậy trên tài khoản của bạn.
409	PLAN_NOT_ACTIVE	Proxy chỉ có thể được tạo cho một gói hoạt động.
409	PLAN_NOT_READY	Gói chưa có thông tin xác thực proxy. Thử lại sau.
409	IDEMPOTENCY_KEY_REUSED	Idempotency-Key này đã được sử dụng cho phần mở rộng khác.
409	REQUEST_IN_PROGRESS	Phần mở rộng với Idempotency-Key này vẫn đang chạy. Thử lại trong giây lát.
409	PRICE_MISMATCH	Giá đã thay đổi trong khi xử lý. Thử lại với Idempotency-Key mới.
422	EXTENSION_NOT_SUPPORTED	Gói này không thể được mở rộng thông qua API. Mở rộng nó trong bảng điều khiển.
422	PROXIES_NOT_SUPPORTED	Các gói chuyên dụng có danh sách IP cố định. Tải xuống từ bảng điều khiển.
422	USAGE_HISTORY_NOT_SUPPORTED	Sản phẩm này không có lịch sử sử dụng. Sử dụng các điểm cuối sử dụng cho các bộ đếm của nó.
422	IPS_NOT_SUPPORTED	Gói này sử dụng cổng quay, không phải danh sách IP cố định. Sử dụng Generate proxies.
422	CUSTOM_PLAN_EXTEND_VIA_SUPPORT	Các gói tùy chỉnh được mở rộng bởi hỗ trợ chỉ.
429	RATE_LIMITED	Quá nhiều yêu cầu. Chờ Retry-After, sau đó thử lại.
500	INTERNAL_ERROR	Lỗi tạm thời. Thử lại.
502	EXTENSION_FAILED	Phần mở rộng không hoàn thành. Chỉ thử lại với cùng Idempotency-Key nếu thông báo cho biết chưa bị trừ tiền; nếu không, hãy liên hệ hỗ trợ.
503	IPS_UNAVAILABLE	Danh sách IP không thể được tải ngay bây giờ. Thử lại sau một phút.