Menu tài liệu

API token

Mọi token proxy: liệt kê và đọc, mức sử dụng của một hoặc nhiều token, và với proxy trả theo GB thì tạo, thay đổi, cấp lại thông tin đăng nhập và xóa. Các token không giới hạn có thể đổi vị trí cũng có vị trí, xoay IP và IP mới theo yêu cầu.

Liệt kê và đọc#

GET /api/v1/tokens
Authorization: Bearer lit_...
Tham số Kiểu Quy tắc
limit integer Số nguyên 1-100; mặc định 50.
cursor string page.nextCursor của trang trước, gửi lại nguyên vẹn.
type string unlimited hoặc ppg.
status string active, expired hoặc disabled.
packageId integer ID số công khai của một gói thuộc về bạn. Giá trị không xác định hoặc của người khác trả về danh sách trống. Giá trị sai định dạng là INVALID_PACKAGE_ID.

Kết quả được sắp xếp từ mới nhất. Hãy tiếp tục yêu cầu page.nextCursor được trả về cho đến khi nó là null.

GET /api/v1/tokens/{tokenId}
Authorization: Bearer lit_...

Trả về một token với cấu trúc giống hệt một phần tử trong danh sách GET /tokens, gồm cả username và password. tokenId không tồn tại, không thuộc tài khoản của bạn hoặc không phân tích được sẽ trả về 404 TOKEN_NOT_FOUND; phản hồi không bao giờ tiết lộ token của người dùng khác.

Ví dụ#

Một token datacenter không giới hạn, trong gói có IP được phép và vị trí có thể đổi:

{
  "id": 12345,
  "type": "unlimited",
  "status": "active",
  "disabledReason": null,
  "label": "Production crawler",
  "externalRef": null,
  "createdAt": "2026-08-01T10:15:00.000Z",
  "expiresAt": "2026-12-01T00:00:00.000Z",
  "allowanceBytes": null,
  "allowanceReservedBytes": null,
  "ingress": {
    "hub": "us-11",
    "protocol": "http",
    "mode": "assigned",
    "host": "hub-us-11-1.litport.net",
    "port": 31337,
    "status": "available"
  },
  "packageId": 45,
  "ipAuth": { "host": "hub-us-11-1.litport.net", "port": 31338 },
  "location": { "country": "us", "region": "new-york", "city": "new-york-city" },
  "rotation": { "intervalSec": 600, "options": [600, 1800, 3600], "changeable": true },
  "username": "proxy-username",
  "password": "proxy-password"
}

Một token trả theo GB, gắn với một pool, có mã tham chiếu, ngày hết hạn và giới hạn lưu lượng:

{
  "id": 12399,
  "type": "ppg",
  "status": "active",
  "disabledReason": null,
  "label": "Residential crawler",
  "externalRef": "customer-1042",
  "createdAt": "2026-08-01T10:15:00.000Z",
  "expiresAt": "2026-12-31T23:59:59.999Z",
  "allowanceBytes": 5000000000,
  "allowanceReservedBytes": 1200000000,
  "ingress": {
    "hub": "example-hub",
    "protocol": "http",
    "mode": "request-selected",
    "supportedProtocols": ["http", "https", "socks5"]
  },
  "poolSelection": {
    "mode": "fixed",
    "pool": { "authKey": "residential-main", "name": "Residential Main" }
  },
  "packageId": null,
  "ipAuth": null,
  "username": "proxy-username",
  "password": "proxy-password"
}

Các định danh và hub ví dụ trong tài liệu này chỉ mang tính minh họa.

Ý nghĩa các trường#

type là ppg hoặc unlimited. status là active, expired hoặc disabled. Giá trị này không bao giờ là hub-unavailable; giá trị đó thuộc về ingress.status, bên dưới.

disabledReason cho biết lý do token không phục vụ lưu lượng. Giá trị là null khi status là active.

status disabledReason Ý nghĩa
disabled owner Bị tắt, do bạn (enabled: false) hoặc, với token của một gói, do chính gói đó.
disabled ban Bị tắt vì tài khoản bị chặn.
expired expired Đã quá expiresAt.
disabled allowance Đang bật, nhưng toàn bộ giới hạn lưu lượng đã dùng hết. Hãy tăng hoặc bỏ giới hạn để bật lại.
disabled balance Đang bật, nhưng số dư tài khoản không đủ để thanh toán cho token. Hãy nạp tiền để dùng lại.

Bộ lọc status trên GET /tokens chỉ chọn theo công tắc bật/tắt riêng của token và ngày hết hạn của nó. Bộ lọc không tìm thấy token bị disabled do allowance hoặc balance, nên hãy đọc disabledReason trong kết quả.

externalRef là mã tham chiếu của riêng bạn cho một proxy trả theo GB, hoặc null. expiresAt là lúc token dừng, hoặc null. allowanceBytes là giới hạn lưu lượng tính bằng byte, hoặc null nếu không có giới hạn, và allowanceReservedBytes là phần đã được giữ lại cho đến nay, hoặc null nếu không có giới hạn.

Với token PPG, ingress.mode là request-selected: không có một host hay cổng duy nhất, vì hub, giao thức và pool được chọn theo từng yêu cầu hoặc lần xuất. ingress.hub và ingress.protocol là tùy chọn ưu tiên cho bảng điều khiển/xuất, còn ingress.supportedProtocols liệt kê các lựa chọn. Lấy host từ hubs của pool và cổng từ httpPort/socks5Port của pool trong Trả theo GB.

Với token không giới hạn, ingress.mode là assigned: token được ánh xạ tới đúng một endpoint, luôn được báo là ingress.host và ingress.port. ingress.status là available hoặc hub-unavailable. hub-unavailable nghĩa là token trỏ tới một hub không còn hoạt động: khi đó ingress.host và ingress.port là null, và thông tin đăng nhập không dùng được cho đến khi bộ phận hỗ trợ chuyển token sang một hub hiện hành.

packageId là ID gói dạng số công khai khi token thuộc một gói bạn sở hữu, nếu không thì là null; đọc gói bằng Gói. ipAuth là {host, port}, endpoint không cần mật khẩu của token, hoặc null khi token hiện không có endpoint nào như vậy. Endpoint này chỉ chấp nhận kết nối từ IP được phép của gói.

location chỉ có trên token có thể đổi vị trí; Vị trí liệt kê token nào đủ điều kiện. Cấu trúc của nó phụ thuộc vào loại: token datacenter hoặc ISP báo {country, region, city}; token di động báo {country, city, carrier}.

rotation là {intervalSec, options, changeable}, có trên mọi token xoay theo bộ hẹn giờ. Xem Xoay IP.

rotateUrl là liên kết đổi IP của một Thiết bị riêng hoặc của token datacenter/ISP xoay, chỉ có khi token có liên kết đó. Hãy giữ nó riêng tư như mật khẩu đi kèm. Xem Liên kết đổi IP bên dưới, và Đổi IP để biết các cách lấy IP mới.

username và password là thông tin đăng nhập proxy của token. Dùng chúng với endpoint hiển thị trong ingress hoặc trong bảng điều khiển.

Nếu tài khoản đã bật Dùng địa chỉ trung lập, các hostname mà API này trả về (ingress.host, ipAuth.host), authKey của pool và liên kết rotateUrl đều mang tên trung lập. Tên pool bạn gửi được chấp nhận ở cả hai dạng. Với proxy HTTPS, hãy dùng ingress.httpsHost (token không giới hạn dùng giao thức http): chứng chỉ được cấp cho tên đó. Đó là tên riêng của hub, và bằng ingress.host trừ khi tài khoản dùng địa chỉ trung lập. Với token trả theo GB, lấy httpsHostname từ hubs của pool.

Tạo và quản lý proxy#

Proxy trả theo GB có thể được tạo, thay đổi và xóa qua API, và thông tin đăng nhập của bất kỳ proxy nào bạn sở hữu đều có thể được cấp lại. Biểu mẫu proxy trả theo GB trong bảng điều khiển tuân theo cùng các quy tắc. Mọi lệnh gọi ở đây đều cần API key dạng Bearer, và thao tác ghi được tính vào giới hạn 120 yêu cầu mỗi 60 giây của key.

Các proxy của một gói thuộc về gói đó, gói tạo và kết thúc chúng, đồng thời bật và tắt chúng. Với các proxy này, bạn chỉ có thể đổi nhãn và cấp lại thông tin đăng nhập, không làm được gì khác.

Mọi tài khoản đều được phép bán lại. Bạn chịu trách nhiệm về cách khách hàng của bạn dùng proxy: một khách hàng lạm dụng có thể khiến cả tài khoản của bạn bị chặn.

Tạo proxy#

POST /api/v1/tokens
Authorization: Bearer lit_...
Content-Type: application/json

Gửi một đối tượng JSON, tối thiểu là {}. Yêu cầu không có nội dung sẽ không tạo gì cả.

Trường Quy tắc
pool Tùy chọn. authKey của một pool trong Trả theo GB. Bỏ qua, hoặc gửi null, để có proxy chọn pool theo từng yêu cầu. Một pool bạn không thể chọn sẽ trả về 400 INVALID_POOL.
label Tùy chọn. Tối đa 255 ký tự.
externalRef Tùy chọn, và nên luôn gửi. 1 đến 128 ký tự in được, không trùng giữa các proxy chưa bị xóa của bạn.
expiresAt Tùy chọn. Một ngày giờ ISO 8601 có múi giờ, như 2026-12-31T10:00:00Z, hoặc một ngày, như 2026-12-31, nghĩa là cuối ngày đó theo UTC. Phải sau thời điểm hiện tại. Proxy dừng vào lúc đó.
allowanceBytes Tùy chọn. Giới hạn lưu lượng tính bằng byte, một số nguyên tối thiểu là 1.
curl -X POST 'https://litport.net/api/v1/tokens' \
  -H "Authorization: Bearer $LITPORT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"pool": "residential-main", "label": "Residential crawler", "externalRef": "customer-1042", "expiresAt": "2026-12-31", "allowanceBytes": 5000000000}'

Phản hồi là 201 kèm proxy theo cấu trúc trong mục Ví dụ, cùng username và password của proxy. Tạo tên người dùng proxy từ chúng như mô tả trong Tham số proxy trả theo GB.

Hãy luôn gửi externalRef. Đó là mã tham chiếu của riêng bạn, chẳng hạn ID khách hàng hoặc số đơn hàng. Một lệnh tạo lặp lại externalRef bạn đang dùng sẽ trả về 200 kèm proxy đó và không thay đổi gì, ngay cả khi phần còn lại của nội dung khác đi. Vì vậy, nếu lệnh tạo bị hết thời gian chờ hoặc bạn mất phản hồi, hãy gửi lại với cùng externalRef và bạn sẽ nhận được proxy đã có. Nếu không có externalRef, một lần lặp có thể tạo ra proxy thứ hai. Proxy đã xóa trả lại externalRef của nó, nên bạn có thể dùng lại.

Việc tạo cần số dư dương (INSUFFICIENT_BALANCE) và tài khoản không bị chặn (ACCOUNT_BANNED). Một tài khoản có thể giữ một số lượng proxy trả theo GB có giới hạn (TOKEN_LIMIT_REACHED); hãy liên hệ hỗ trợ để tăng giới hạn.

Một tài khoản có thể tạo 60 proxy mới mỗi phút, tính chung tất cả API key của nó và bảng điều khiển. Việc lặp lại externalRef bạn đang dùng không được tính. Vượt giới hạn, lệnh tạo trả về 429 RATE_LIMITED kèm Retry-After, và không có gì được tạo: hãy gửi lại đúng yêu cầu đó sau khi chờ.

Thay đổi proxy#

PATCH /api/v1/tokens/{tokenId}
Authorization: Bearer lit_...
Content-Type: application/json

Chỉ gửi các trường bạn muốn thay đổi, và ít nhất một trường. Trường bạn bỏ qua giữ nguyên. null xóa label, pool, expiresAt và allowanceBytes.

Trường Quy tắc
label Tối đa 255 ký tự, hoặc null.
enabled false tắt proxy, true bật proxy. Bật lên cần số dư dương và tài khoản không bị chặn.
pool authKey của một pool, hoặc null để proxy chọn pool theo từng yêu cầu. Proxy đăng nhập bằng IP được phép giữ nguyên pool của nó: null sẽ trả về 409 POOL_REQUIRED_FOR_IP_AUTH.
expiresAt Một ngày giờ hoặc ngày sau thời điểm hiện tại, như khi tạo, hoặc null để không hết hạn.
allowanceBytes Giới hạn lưu lượng tính bằng byte, một số nguyên tối thiểu là 1, hoặc null để bỏ giới hạn.

Phản hồi là 200 kèm proxy ở trạng thái hiện tại. Nội dung không thay đổi gì thì không ghi gì. Pool mới áp dụng cho các kết nối mới; các kết nối đang mở giữ pool mà chúng bắt đầu và bị tính phí theo giá của pool đó.

Tắt, đổi nhãn, đổi ngày hết hạn hoặc giới hạn luôn thực hiện được, kể cả khi số dư bằng 0, nên bạn có thể ngắt một khách hàng bất cứ lúc nào. Cấp lại thông tin đăng nhập và xóa cũng vậy. Với proxy của một gói, label là trường duy nhất; mọi trường khác trả về 400 FIELD_NOT_ALLOWED.

Cấp lại thông tin đăng nhập#

POST /api/v1/tokens/{tokenId}/credentials
Authorization: Bearer lit_...
Content-Type: application/json

{"requestId": "reissue-2026-11-04-a"}

Cấp tên người dùng, mật khẩu và khóa đổi IP mới cho bất kỳ proxy nào bạn sở hữu, trả theo GB hay thuộc gói. Phản hồi là 200 kèm proxy theo cấu trúc trong mục Ví dụ, với username và password mới, và rotateUrl mới nếu proxy có. Nội dung yêu cầu là tùy chọn.

  • Mật khẩu cũ ngừng hoạt động, và các kết nối đang mở của nó bị đóng.
  • Liên kết đổi IP cũ ngừng hoạt động.
  • IP được phép của một gói vẫn hoạt động, và các kết nối của chúng vẫn mở. IP được phép thuộc về cả gói, không thuộc về một proxy riêng lẻ, nên việc cấp lại một proxy không thể ngắt một khách hàng đang kết nối từ IP được phép. Hãy chia sẻ một gói cho nhiều khách hàng chỉ bằng mật khẩu.

requestId dài 1 đến 64 ký tự: chữ cái, chữ số, dấu gạch dưới hoặc dấu gạch ngang. Dùng requestId mới cho mỗi lần cấp lại mà bạn thực sự muốn. Chỉ gửi lại đúng giá trị cũ để thử lại một lệnh gọi mà bạn không nhận được phản hồi: lần lặp sẽ trả về thông tin đăng nhập mà lệnh gọi đầu đã cấp và không cấp gì mới, dù lệnh gọi đầu đã xong hay vẫn đang chạy. Khi không có requestId, mỗi lệnh gọi cấp một cặp mới, nên đừng lặp lại một cách máy móc.

Xóa proxy#

DELETE /api/v1/tokens/{tokenId}
Authorization: Bearer lit_...

Xóa một proxy trả theo GB. Phản hồi là 204 không có nội dung. Proxy ngừng hoạt động và các kết nối đang mở của nó bị đóng. Lịch sử của nó vẫn còn: mức sử dụng của nhiều token vẫn liệt kê nó, đánh dấu deleted, và GET /tokens/{tokenId}/usage vẫn trả lời cho nó. GET /tokens và GET /tokens/{tokenId} không còn trả về nó. Xóa một proxy đã bị xóa lại trả về 204.

Proxy của một gói không thể bị xóa: 409 NOT_SUPPORTED. Nó kết thúc cùng gói của nó.

Giới hạn lưu lượng#

Một proxy trả theo GB có thể có giới hạn lưu lượng, allowanceBytes: lượng lưu lượng tối đa nó được dùng, tính bằng byte (1 GB là 1,000,000,000 byte). Dùng nó để cấp cho mỗi khách hàng, thành viên nhóm hoặc công cụ một lượng cố định. Giới hạn là tùy chọn. Trong bảng điều khiển, đó là trường Giới hạn lưu lượng (GB) của proxy.

  • Cái gì được tính. Toàn bộ lưu lượng giữa client và hub, theo cả hai chiều, bao gồm phần overhead của giao thức. Vì vậy giới hạn không bao giờ nhỏ hơn lưu lượng bị tính phí trong mức sử dụng: lưu lượng bị tính phí của một proxy không bao giờ vượt giới hạn của nó.
  • Nơi nó dừng. Proxy có thể dừng hơi sớm hơn giới hạn, nhưng không bao giờ vượt quá. Litport giữ lưu lượng cho một proxy trước khi dùng, và phần không dùng đến sẽ không được trả lại.
  • allowanceReservedBytes. Lượng lưu lượng trong giới hạn đã được giữ lại cho đến nay. Đây không phải cùng một con số với mức sử dụng bị tính phí: nó có thể vượt trước lưu lượng đã chuyển, và không bao giờ bị trừ vào số tiền bạn bị tính. Hãy đọc lưu lượng bị tính phí từ mức sử dụng.
  • Việc tính phí không đổi. Hạn mức chỉ từ chối lưu lượng.
  • Khi đã dùng hết. status là disabled, disabledReason là allowance, và các kết nối mới nhận lỗi proxy 24 (HTTP 403). Hãy tăng hoặc bỏ giới hạn để dùng lại proxy.
  • Thay đổi giới hạn. Thêm, tăng, giảm hoặc bỏ giới hạn sẽ kết thúc các kết nối đang mở của proxy một lần; client kết nối lại theo giới hạn mới. Giới hạn bị giảm xuống dưới phần đã giữ lại sẽ dừng proxy ngay khi dùng hết lưu lượng đã giữ. Không có gì bị lấy lại.

Lỗi ghi proxy#

Trạng thái Mã Ý nghĩa
400 INVALID_REQUEST_BODY Nội dung không phải đối tượng JSON, có trường mà lệnh gọi không nhận, hoặc (PATCH) không có trường nào.
400 FIELD_NOT_ALLOWED PATCH gửi cho proxy của một gói một trường khác label.
400 INVALID_LABEL, INVALID_EXTERNAL_REF, INVALID_REQUEST_ID, INVALID_ENABLED, INVALID_EXPIRY, INVALID_ALLOWANCE Trường được nêu nằm ngoài phạm vi hoặc sai kiểu.
400 INVALID_POOL pool không phải là pool bạn có thể chọn.
402 INSUFFICIENT_BALANCE Tạo hoặc bật cần số dư dương.
403 ACCOUNT_BANNED Không được tạo hoặc bật khi tài khoản bị chặn.
404 TOKEN_NOT_FOUND tokenId không tồn tại, không thuộc tài khoản của bạn hoặc sai định dạng.
409 NOT_SUPPORTED DELETE trên proxy của một gói.
409 TOKEN_LIMIT_REACHED Tài khoản đã có số proxy trả theo GB tối đa được phép giữ.
409 ALLOWANCE_CONFLICT Không thể lưu giới hạn. Hãy gửi lại đúng yêu cầu đó.
409 POOL_REQUIRED_FOR_IP_AUTH Proxy đăng nhập bằng IP được phép không thể bỏ pool.
409 TOKEN_NOT_EDITABLE Proxy không còn sửa được nữa, ví dụ vì nó bị xóa trong lúc thao tác ghi đang chạy. Không có gì thay đổi.
409 CONCURRENT_CHANGE Một thao tác ghi khác vào proxy này đến cùng lúc. Hãy gửi lại đúng yêu cầu đó.
429 RATE_LIMITED Tạo: vượt giới hạn proxy mới của tài khoản trong phút vừa qua (hoặc giới hạn yêu cầu của key). Không có gì được tạo. Chờ theo Retry-After, rồi gửi lại đúng yêu cầu đó.

Mọi mã đều có một mục riêng tại Lỗi API.

Mức sử dụng#

Đọc lưu lượng mà khách hàng nhìn thấy cho một token bạn sở hữu.

GET /api/v1/tokens/{tokenId}/usage
Authorization: Bearer lit_...

Tham số truy vấn#

Tham số Quy tắc
from Mốc thời gian ISO-8601 UTC chuẩn, bao gồm chính nó.
to Mốc thời gian ISO-8601 UTC chuẩn, không bao gồm chính nó; phải sau from.
groupBy hour, day hoặc month; mặc định là day.
include domains và/hoặc charges, cách nhau bằng dấu phẩy. charges yêu cầu groupBy=hour.

Khi bỏ qua khoảng thời gian, API dùng 30 ngày UTC trọn vẹn trước ngày UTC hiện tại. Khoảng theo giờ giới hạn ở 31 ngày, khoảng theo ngày ở 366 ngày, và khoảng theo tháng ở 36 tháng.

Ví dụ#

curl --get 'https://litport.net/api/v1/tokens/12345/usage' \
  -H "Authorization: Bearer $LITPORT_API_KEY" \
  --data-urlencode 'from=2026-08-01T00:00:00Z' \
  --data-urlencode 'to=2026-08-03T00:00:00Z' \
  --data-urlencode 'groupBy=day'
{
  "data": {
    "tokenId": 12345,
    "deleted": false,
    "range": {
      "from": "2026-08-01T00:00:00.000Z",
      "to": "2026-08-03T00:00:00.000Z",
      "groupBy": "day",
      "timezone": "UTC"
    },
    "trafficBasis": "customer_chargeable",
    "summary": {
      "requests": 42,
      "uploadedBytes": "12000",
      "downloadedBytes": "88000",
      "totalBytes": "100000",
      "cache": {
        "hits": 12,
        "misses": 4,
        "bypasses": 2,
        "hitRate": 0.75,
        "freeUploadedBytes": "0",
        "freeDownloadedBytes": "24000",
        "freeTotalBytes": "24000",
        "savedCostUnits": "0.0324"
      }
    },
    "buckets": [
      {
        "start": "2026-08-01T00:00:00.000Z",
        "end": "2026-08-02T00:00:00.000Z",
        "requests": 42,
        "uploadedBytes": "12000",
        "downloadedBytes": "88000",
        "totalBytes": "100000",
        "cache": {
          "hits": 12,
          "misses": 4,
          "bypasses": 2,
          "hitRate": 0.75,
          "freeUploadedBytes": "0",
          "freeDownloadedBytes": "24000",
          "freeTotalBytes": "24000",
          "savedCostUnits": "0.0324"
        }
      }
    ]
  }
}

Ý nghĩa của mức sử dụng#

Khoảng thời gian là nửa mở: [from, to). Các bucket được sắp xếp theo thời điểm bắt đầu và thưa; thiếu một bucket nghĩa là không có dòng tổng hợp nào được lưu, không phải lỗi API.

Với token PPG, trafficBasis là customer_chargeable, nên tổng lưu lượng khớp với lưu lượng hiển thị cho khách hàng. Với token giá cố định/không giới hạn, nó là observed; các tổng lưu lượng hiện có đó vẫn là cơ sở lưu lượng quan sát được. Các tổng byte lớn là chuỗi số thập phân để client giữ nguyên giá trị chính xác. requests là số nguyên JSON.

Lợi ích của bộ nhớ đệm#

Mỗi bucket và phần tóm tắt đều có cache. hits, misses và bypasses là số nguyên JSON; hitRate là hits / (hits + misses) và bằng 0 khi không có lượt hit hay miss nào. freeUploadedBytes, freeDownloadedBytes và freeTotalBytes là các chuỗi số thập phân cơ số 10 không âm, với freeTotalBytes bằng tổng hai giá trị theo từng chiều. Các giai đoạn cũ không có dữ liệu đo bộ nhớ đệm báo các trường này bằng 0.

Chỉ với token PPG, cache.savedCostUnits là chuỗi số thập phân cơ số 10 không âm cho khoản phí đã được kiểm toán mà bạn tránh phải trả, theo mức giá có hiệu lực khi lưu lượng phát sinh. Trường này cố ý được bỏ đi, không đặt là 0 hay null, với token không giới hạn vì không có khoản phí theo GB nào của khách hàng được tránh.

Token phải thuộc về người dùng đã xác thực. Token không tồn tại hoặc không thuộc tài khoản của bạn trả về cùng một phản hồi 404 TOKEN_NOT_FOUND. Token đã xóa vẫn trả lời, với deleted: true, để hóa đơn cuối cùng của khách hàng vẫn đọc được sau khi proxy không còn.

Chi tiết khoản thu phí#

Với token PPG, hãy yêu cầu include=charges&groupBy=hour để thêm khoản thu phí đã lưu vào từng bucket theo giờ. Phần mở rộng này bị từ chối với token không giới hạn. Một khoản thu phí có phiên bản gồm khóa công khai và tên của pool, số byte tải lên/tải xuống thô và đã tính phí, các hub và giao thức đóng góp, giá cơ sở/hiệu lực và mức giảm giá đã chụp lại, cùng số tiền chính xác đã trừ. Một dòng không có ảnh chụp được gắn nhãn Legacy PPG usage; API không đoán pool hay mức giá của nó từ cài đặt hiện tại của token.

Các thành phần của khoản thu phí là bản ghi thanh toán. Cả tải lên và tải xuống đều bị tính phí. Một khoản thu phí reserved có thể tăng khi lưu lượng đến muộn của giờ đó được ghi nhận; khoản thu phí finished là cuối cùng.

Chi tiết theo tên miền#

Hãy yêu cầu include=domains để thêm domainBreakdown vào data:

{
  "domainBreakdown": {
    "limit": 150,
    "totalDestinationCount": 151,
    "displayedCount": 150,
    "truncated": true,
    "range": {
      "from": "2026-08-01T00:00:00.000Z",
      "to": "2026-08-03T00:00:00.000Z",
      "timezone": "UTC",
      "periodClamped": false,
      "endClamped": false
    },
    "items": [{
      "protocol": "tcp",
      "destination": "example.com",
      "port": 443,
      "requests": 42,
      "uploadedBytes": "12000",
      "downloadedBytes": "88000",
      "totalBytes": "100000",
      "lastSeenAt": "2026-08-01T12:00:00.000Z",
      "firstSeenAt": "2026-08-01T00:00:00.000Z"
    }],
    "other": {
      "protocol": null,
      "destination": "Other",
      "port": null,
      "requests": 1,
      "uploadedBytes": "1",
      "downloadedBytes": "2",
      "totalBytes": "3",
      "lastSeenAt": null,
      "firstSeenAt": null
    }
  }
}

Phản hồi gồm tối đa 150 đích có tổng lưu lượng cao nhất. Mọi đích còn lại và phần dữ liệu đo bị tràn được gộp vào other; truncated báo khi việc gộp đó xảy ra. requests của TCP là số yêu cầu thành công và requests của UDP là số datagram đến. Dữ liệu tên miền được lưu theo các bucket UTC nguyên giờ và giới hạn trong 31 ngày gần nhất của khoảng được yêu cầu. range UTC trả về là khoảng bucket hiệu lực: điểm bắt đầu lẻ trong quá khứ được làm tròn xuống đầu giờ và điểm kết thúc lẻ trong quá khứ được làm tròn lên giờ kế tiếp. Điểm kết thúc bị giới hạn ở thời điểm hiện tại giữ đúng thời điểm đó, nên phản hồi không tuyên bố bao phủ quá thời điểm hiện tại. Khoảng này cũng báo periodClamped hoặc endClamped khi đã được điều chỉnh.

Mức sử dụng của nhiều token#

Đọc mức sử dụng của nhiều proxy trong một lệnh gọi, theo từng ngày. Các proxy đã xóa được bao gồm, để bạn có thể chốt hóa đơn cuối cùng của một khách hàng đã rời đi.

GET /api/v1/usage
Authorization: Bearer lit_...

Tham số danh sách mức sử dụng#

Tham số Quy tắc
from Mốc thời gian ISO-8601 UTC chuẩn, bao gồm chính nó.
to Mốc thời gian ISO-8601 UTC chuẩn, không bao gồm chính nó; phải sau from.
tokenIds ID proxy, cách nhau bằng dấu phẩy hoặc dưới dạng tham số lặp lại, tối đa 100. Bỏ qua để lấy mọi proxy. ID không thuộc về bạn sẽ bị bỏ qua. Danh sách sai định dạng trả về 400 INVALID_TOKEN_IDS.
limit Số nguyên 1-100; mặc định là 50. Số proxy trong một trang.
cursor page.nextCursor của trang trước, gửi lại nguyên vẹn.

Khi bỏ qua khoảng thời gian, API dùng 30 ngày UTC trọn vẹn trước ngày UTC hiện tại. Một khoảng bị giới hạn ở 92 ngày (400 INVALID_TIME_RANGE nếu vượt); hãy đọc khoảng dài hơn bằng nhiều lệnh gọi. Lệnh gọi này bị giới hạn ở 10 yêu cầu mỗi 60 giây cho mỗi API key (429 RATE_LIMITED), và RateLimit-* cùng Retry-After báo giới hạn đó.

Ví dụ danh sách mức sử dụng#

curl --get 'https://litport.net/api/v1/usage' \
  -H "Authorization: Bearer $LITPORT_API_KEY" \
  --data-urlencode 'from=2026-10-01T00:00:00Z' \
  --data-urlencode 'to=2026-10-03T00:00:00Z' \
  --data-urlencode 'tokenIds=12399,12400'
{
  "data": {
    "range": {
      "from": "2026-10-01T00:00:00.000Z",
      "to": "2026-10-03T00:00:00.000Z",
      "groupBy": "day",
      "timezone": "UTC"
    },
    "tokens": [
      {
        "tokenId": 12399,
        "type": "ppg",
        "deleted": false,
        "label": "Residential crawler",
        "externalRef": "customer-1042",
        "trafficBasis": "customer_chargeable",
        "summary": {
          "requests": 42,
          "uploadedBytes": "12000",
          "downloadedBytes": "88000",
          "totalBytes": "100000",
          "costUnits": "0.00045"
        },
        "buckets": [
          {
            "start": "2026-10-01T00:00:00.000Z",
            "end": "2026-10-02T00:00:00.000Z",
            "requests": 42,
            "uploadedBytes": "12000",
            "downloadedBytes": "88000",
            "totalBytes": "100000",
            "costUnits": "0.00045"
          }
        ]
      },
      {
        "tokenId": 12400,
        "type": "ppg",
        "deleted": true,
        "label": null,
        "externalRef": "customer-0977",
        "trafficBasis": "customer_chargeable",
        "summary": {
          "requests": 0,
          "uploadedBytes": "0",
          "downloadedBytes": "0",
          "totalBytes": "0",
          "costUnits": "0"
        },
        "buckets": []
      }
    ]
  },
  "page": { "nextCursor": null }
}

Ý nghĩa của danh sách mức sử dụng#

Một trang chứa tối đa limit proxy, mới nhất trước, mỗi proxy có một summary cho khoảng thời gian và một bucket cho mỗi ngày UTC có lưu lượng. Khoảng thời gian là nửa mở, [from, to), và các bucket thưa, như với một token. Hãy tiếp tục yêu cầu page.nextCursor cho đến khi nó là null; một trang có thể chứa ít hơn limit proxy, vì các proxy đã xóa không có mức sử dụng bị lược bỏ.

Thông tin đăng nhập không bao giờ xuất hiện ở đây. trafficBasis, các chuỗi byte và requests mang cùng ý nghĩa như với một token. Danh sách này không có lợi ích bộ nhớ đệm, chi tiết theo tên miền hay khoản thu phí theo giờ; hãy đọc các mục đó bằng GET /tokens/{tokenId}/usage.

costUnits là số tiền bị tính phí, theo đơn vị số dư, dưới dạng chuỗi số thập phân. Một proxy trả theo GB có trường này ở mỗi ngày và trong summary của nó; costUnits của một bucket là null với ngày có lưu lượng nhưng chưa ghi nhận khoản thu phí nào, và khoản thu phí của giờ đang chạy có thể thay đổi. Nó là null với proxy của một gói, vốn không bị tính phí theo GB.

Các proxy đã xóa được liệt kê với deleted: true và externalRef mà chúng từng có. Một proxy đã xóa không có mức sử dụng trong khoảng thời gian chỉ xuất hiện khi bạn nêu tên nó trong tokenIds. Một proxy trả theo GB chưa bị xóa luôn xuất hiện. Proxy của một gói xuất hiện trừ khi nó đã hết hạn trước from.

Vị trí#

Token datacenter hoặc ISP, và token di động có thể đổi thành phố hoặc nhà mạng, báo trường location và hỗ trợ API này. Token nào đủ điều kiện, và một thay đổi hoạt động ra sao:

Token Thay đổi Thời gian chờ
Datacenter/ISP, xoay Bất cứ lúc nào Không
Datacenter/ISP, tĩnh IP mới ở vị trí đã chọn Mỗi tuần một lần
Datacenter/ISP, tĩnh, đang ở ngoài vị trí đã lưu Chuyển về vị trí đã lưu Không
Di động “Đa vị trí” (tiện ích bổ sung trả phí) Bất cứ lúc nào Không
Di động dùng chung tiêu chuẩn tại Mỹ Thành phố và nhà mạng cùng nhau Mỗi 48 giờ một lần
Mọi loại còn lại (PPG, Thiết bị riêng, di động ngoài Hoa Kỳ, gói 1 ngày, hoặc token cũ không có loại cổng) Không hỗ trợ Không
GET /api/v1/tokens/{tokenId}/location
Authorization: Bearer lit_...
{
  "data": {
    "tokenId": 12345,
    "kind": "datacenter",
    "mode": "rotating",
    "target": { "country": "us", "region": "new-york", "city": "new-york-city" },
    "effective": {
      "country": "us", "region": "new-york", "city": "new-york-city",
      "labels": { "region": "New York", "city": "New York City" }
    },
    "status": "ready",
    "canChangeNow": true,
    "nextChangeAt": null
  }
}

kind là datacenter, isp hoặc mobile. mode là rotating hoặc static. target là lựa chọn đã lưu; region/city của datacenter/ISP có thể là "any". effective là vị trí thực tế của IP mà token đang giữ lúc này, hoặc null khi chưa biết. status là pending trong thời gian ngắn khi một thay đổi đang lan truyền, ready khi đã xong, package-inactive khi gói của token không hoạt động, hoặc allowance-exhausted, chỉ với gói “Đa vị trí” cũ vẫn còn áp dụng giới hạn lưu lượng. Token datacenter hoặc ISP báo thêm hai giá trị nữa, được xác định từ vị trí hiện tại của IP:

  • fallback: proxy đang chạy trên một IP ngoài vị trí đã lưu, vì vị trí đó không còn IP trống. Proxy xoay tự quay về khi có IP trống ở đó. Proxy tĩnh giữ nguyên chỗ cho đến khi bạn chuyển nó về, vì một IP tự đổi mà không có yêu cầu sẽ làm hỏng danh sách cho phép trên các trang mà nó được dùng.
  • unavailable: IP của proxy hiện không hoạt động; nó đang được chuyển sang một IP hoạt động, thường mất vài phút.

fallback là giá trị mới hơn, nên client rẽ nhánh theo status cần xử lý nó. Với token di động, unavailable vẫn có nghĩa là vị trí đích hiện không có thiết bị nào hoạt động (token giữ thiết bị cuối cùng thay vì mất tuyến).

Liệt kê các vị trí khả dụng#

GET /api/v1/tokens/{tokenId}/location/options?level=region
GET /api/v1/tokens/{tokenId}/location/options?level=city&region=new-york

Datacenter/ISP: level=region, rồi level=city&region=…. Di động: level=city, rồi level=carrier&city=…. Mỗi tùy chọn là {"value": …, "label": …}, và danh sách chỉ chứa các tùy chọn mà token này dùng được ngay lúc này.

Đổi vị trí#

Datacenter/ISP:

curl -X PUT 'https://litport.net/api/v1/tokens/12345/location' \
  -H "Authorization: Bearer $LITPORT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"region": "new-york", "city": "new-york-city"}'

Di động:

curl -X PUT 'https://litport.net/api/v1/tokens/98765/location' \
  -H "Authorization: Bearer $LITPORT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"city": "seattle", "carrier": "verizon"}'

Để máy chủ chọn, cho cả hai loại:

curl -X PUT 'https://litport.net/api/v1/tokens/12345/location' \
  -H "Authorization: Bearer $LITPORT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"random": true}'

Hãy gửi đúng các trường cho loại của token đó: datacenter/ISP là region và city; di động là city và carrier. country là tùy chọn và phải là "us" nếu được gửi. Không cần và không áp dụng header điều kiện tiên quyết nào: lệnh PUT được ghi nhận gần nhất trở thành mục tiêu mong muốn của token, và một PUT giống hệt mục tiêu đang lưu sẽ thành công mà không tạo thay đổi mới.

Token datacenter/ISP xoay chuyển ngay sang một IP phù hợp. Token tĩnh nhận một IP mới ở vị trí đã chọn, dùng hạn mức mỗi tuần một lần của nó; lặp lại trong tuần đó trả về 409 CHANGE_LIMIT kèm nextChangeAt. Token “Đa vị trí” chuyển ngay, không phải chờ. Token Di động dùng chung tiêu chuẩn tại Mỹ có thể đổi mỗi 48 giờ một lần; lặp lại trong khoảng đó cũng trả về 409 CHANGE_LIMIT.

Với mọi token di động, thành phố luôn được giữ: nếu nhà mạng đã chọn không có điện thoại hoạt động ở thành phố đó, proxy dùng một nhà mạng khác trong cùng thành phố, và effective cho thấy nhà mạng thực tế đang dùng.

{"random": true} được gửi riêng, không kèm trường nào khác. Máy chủ chọn một vị trí mà proxy này dùng được ngay lúc này, từ chính các giá trị mà Liệt kê các vị trí khả dụng hiển thị: một thành phố khác nếu có, và với proxy di động, khi thành phố của nó là thành phố duy nhất, thì chọn nhà mạng khác trong cùng thành phố. Nó không bao giờ chọn target hiện tại của proxy. Lựa chọn được lưu làm mục tiêu như mọi thay đổi khác, với cùng các kiểm tra và cùng thời gian chờ (proxy datacenter/ISP tĩnh dùng hạn mức mỗi tuần một lần, proxy Di động dùng chung tiêu chuẩn tại Mỹ dùng hạn mức 48 giờ, và CHANGE_LIMIT kèm nextChangeAt như thường lệ), và target trong phản hồi cho thấy proxy đã chuyển đến đâu. Nếu một lựa chọn hóa ra không có IP hoặc điện thoại trống, lựa chọn tiếp theo sẽ được thử, tối đa ba lần. Nếu không có vị trí nào khác, hoặc cả ba lựa chọn đều không nhận được proxy, phản hồi là 409 LOCATION_UNAVAILABLE và không có gì thay đổi.

Một thay đổi ngẫu nhiên không an toàn để lặp lại một cách máy móc: khi không có thời gian chờ nào áp dụng, mỗi lần lặp lại sẽ chuyển proxy thêm một lần nữa. Sau khi mất phản hồi, hãy đọc GET /tokens/{tokenId}/location trước khi gửi lại.

Chuyển về#

POST /api/v1/tokens/{tokenId}/location/return
Authorization: Bearer lit_...

Với token datacenter hoặc ISP tĩnh có status là fallback: token lấy một IP trống ở vị trí đã lưu, trên cùng host, cổng, tên người dùng và mật khẩu. Thao tác này miễn phí: không dùng hạn mức mỗi tuần một lần, và target đã lưu không đổi. Yêu cầu không có nội dung (chấp nhận {} rỗng). Trả về cùng cấu trúc như Vị trí, với IP effective mới. IP thay đổi, nên danh sách cho phép trên trang đích đang giữ IP cũ sẽ không còn khớp.

Token xoay không có yêu cầu như vậy: nó tự quay về khi có IP trống ở vị trí đã lưu. Mọi token khác trả về 409 NOT_SUPPORTED.

Lặp lại sau khi đã thành công trả về 409 NOT_IN_FALLBACK và không cấp IP thứ hai, nên có thể gửi lại yêu cầu một cách an toàn sau khi mất phản hồi.

Trạng thái Mã Ý nghĩa
400 INVALID_REQUEST_BODY Yêu cầu có nội dung không rỗng.
404 TOKEN_NOT_FOUND tokenId không tồn tại, không thuộc tài khoản của bạn hoặc sai định dạng.
409 NOT_SUPPORTED Không phải token datacenter hoặc ISP tĩnh, hoặc không có vị trí đã lưu.
409 PACKAGE_INACTIVE Token hoặc gói của nó không hoạt động.
409 NOT_IN_FALLBACK Token không ở ngoài vị trí đã lưu (lặp lại sau khi thành công sẽ rơi vào đây), hoặc IP của nó chưa hoạt động. Không có gì thay đổi.
409 LOCATION_UNAVAILABLE Vị trí đã lưu chưa có IP trống. Không có gì thay đổi; hãy thử lại sau.
409 CONCURRENT_CHANGE Một thay đổi khác với token này đến cùng lúc. Hãy đọc vị trí và chỉ gửi lại yêu cầu khi status vẫn là fallback.

Lỗi vị trí#

Trạng thái Mã Ý nghĩa
400 INVALID_REQUEST_BODY Nội dung có sai trường cho loại của token này, random không phải true, hoặc random được gửi cùng các trường khác.
400 INVALID_LOCATION Không phải vị trí hoặc nhà mạng được hỗ trợ ở Hoa Kỳ, hoặc là "any" cho token Di động dùng chung tiêu chuẩn.
400 INVALID_LEVEL / INVALID_PARENT Tùy chọn: một level mà token này không dùng, hoặc thiếu region/city.
404 TOKEN_NOT_FOUND tokenId không tồn tại, không thuộc tài khoản của bạn hoặc sai định dạng.
409 NOT_SUPPORTED Không thể đổi vị trí của token này.
409 PACKAGE_INACTIVE Token hoặc gói của nó không hoạt động.
409 CHANGE_LIMIT Đang trong thời gian chờ theo tuần hoặc 48 giờ. Lỗi kèm nextChangeAt và Retry-After tương ứng.
409 LOCATION_UNAVAILABLE Hiện không có IP dùng được hoặc điện thoại hoạt động ở đó, hoặc, với random, không có vị trí nào khác khả dụng. Không có gì thay đổi.
409 CONCURRENT_CHANGE Một thay đổi khác với token này đến cùng lúc. Hãy thử lại đúng lệnh PUT đó.

Xoay IP#

PUT /api/v1/tokens/{tokenId}/rotation
Authorization: Bearer lit_...
Content-Type: application/json

{"intervalSec": 600}
{
  "data": { "tokenId": 12345, "intervalSec": 600, "options": [600, 1800, 3600], "changeable": true }
}

intervalSec phải là một trong các options, chính là các giá trị mà trường rotation của token liệt kê. changeable là true với token datacenter/ISP xoay, token Di động dùng chung tiêu chuẩn tại Mỹ và Thiết bị riêng ở Hoa Kỳ. options của một Thiết bị riêng bắt đầu từ 2 phút. Token “Đa vị trí” luôn báo chu kỳ của chiếc điện thoại hiện tại với changeable: false, vì chiếc điện thoại mà proxy đang dùng tự đặt bộ hẹn giờ của nó; lệnh PUT của nó cũng trả về 409 NOT_SUPPORTED, như mọi token không xoay khác.

Lỗi xoay IP#

Trạng thái Mã Ý nghĩa
400 INVALID_REQUEST_BODY Nội dung không đúng dạng {"intervalSec": <integer>}.
400 INVALID_ROTATION intervalSec không nằm trong options của token.
404 TOKEN_NOT_FOUND tokenId không tồn tại, không thuộc tài khoản của bạn hoặc sai định dạng.
409 NOT_SUPPORTED Token không xoay, hoặc chu kỳ của nó do điện thoại đặt (“Đa vị trí”).
409 PACKAGE_INACTIVE Token hoặc gói của nó không hoạt động.

IP mới#

POST /api/v1/tokens/{tokenId}/new-ip
Authorization: Bearer lit_...

Nút Lấy IP mới trên proxy trong bảng điều khiển và Liên kết đổi IP của token là các cách không cần code để làm điều tương tự; xem Đổi IP. Endpoint này chỉ áp dụng cho token datacenter và ISP. Thiết bị riêng đổi IP bằng liên kết đổi IP của nó. Yêu cầu không có nội dung. IP mới nằm trong vị trí đã lưu của token. Token có status là fallback hoặc unavailable (ngoài vị trí của nó, hoặc trên một IP đã ngừng hoạt động) nhận IP trong vị trí đã lưu nếu ở đó còn trống, nếu không thì trong cùng vùng, rồi ở bất kỳ đâu tại Hoa Kỳ. Trả về cùng cấu trúc như Vị trí, với IP effective mới.

Token tĩnh dùng hạn mức mỗi tuần một lần của nó. Dịch vụ dùng lại vị trí đã lưu của chính token ở mỗi lần thử, kể cả lần thử lại.

Token xoay nhận IP mới bất cứ lúc nào. IP mới luôn khác IP hiện tại, và bộ hẹn giờ tự động khởi động lại: lần đổi tự động kế tiếp diễn ra sau lần này rotation.intervalSec giây. Các kết nối mới dùng IP mới trong khoảng 5 giây; các kết nối đang mở giữ IP cũ cho đến khi chúng kết nối lại. Hai yêu cầu phải cách nhau ít nhất giá trị nhỏ nhất trong rotation.options của token; lặp lại trong khoảng chờ đó trả về 409 CHANGE_LIMIT.

Với token tĩnh, đây là thao tác ghi duy nhất không an toàn để lặp lại một cách máy móc. Nếu mất phản hồi hoặc hết thời gian chờ, hãy đọc GET /tokens/{tokenId}/location trước khi thử lại: nextChangeAt muộn hơn thời điểm hiện tại nghĩa là thay đổi đã được thực hiện. Gửi lại POST trong tuần đó sẽ không cấp IP thứ hai; nó trả về 409 CHANGE_LIMIT.

Với token xoay, không thể xác nhận phản hồi bị mất từ GET /tokens/{tokenId}/location: canChangeNow và nextChangeAt của nó nói về vị trí và không cho biết gì về khoảng chờ này. Gửi lại POST sau Retry-After là vô hại; nó chỉ cấp thêm một IP mới. Một 409 CHANGE_LIMIT ngay sau khi mất phản hồi không chứng minh thay đổi đã xảy ra, vì phản hồi 409 LOCATION_UNAVAILABLE cũng làm tiêu hao thời gian chờ.

Lỗi IP mới#

Trạng thái Mã Ý nghĩa
404 TOKEN_NOT_FOUND tokenId không tồn tại, không thuộc tài khoản của bạn hoặc sai định dạng.
409 NOT_SUPPORTED Token không phải proxy datacenter hoặc ISP.
409 PACKAGE_INACTIVE Token hoặc gói của nó không hoạt động.
409 CHANGE_LIMIT Tĩnh: lượt thay thế của tuần này đã dùng. Xoay: đang trong thời gian chờ kể từ yêu cầu gần nhất. Lỗi kèm nextChangeAt và Retry-After tương ứng.
409 LOCATION_UNAVAILABLE Hiện không còn IP dùng được nào khác trong vị trí đã lưu. Không có gì thay đổi; với token xoay, yêu cầu vẫn làm tiêu hao thời gian chờ.
409 CONCURRENT_CHANGE Một thay đổi khác với token này đến cùng lúc. Tĩnh: hãy đọc vị trí rồi thử lại. Xoay: hãy gửi lại yêu cầu sau khi hết thời gian chờ.

rotateUrl đổi IP mà không cần API key: gửi một GET tới nó từ một script hoặc ứng dụng, hoặc mở nó trong trình duyệt. Liên kết được mở như một trang trong tab trình duyệt sẽ hiển thị một trang ngắn bằng ngôn ngữ của khách hàng. Mọi client khác nhận JSON bên dưới, và &format=json luôn trả về JSON, chẳng hạn cho một ứng dụng điều khiển một trình duyệt thật. Ai có liên kết cũng có thể đổi IP, nên hãy giữ nó riêng tư như mật khẩu. Đặt lại bên cạnh liên kết trong bảng điều khiển cấp một liên kết mới, và liên kết cũ ngừng hoạt động ngay. Với token datacenter/ISP xoay, liên kết tuân theo các quy tắc giống POST /tokens/{tokenId}/new-ip ở trên: thời gian chờ giữa các lần đổi, IP mới trong vị trí đã lưu và việc khởi động lại bộ hẹn giờ. Đổi IP là hướng dẫn về liên kết và nút bấm. Mọi phản hồi JSON đều là HTTP 200 với nội dung thuộc bảng này:

Nội dung Ý nghĩa
{"status": "ok"} Xong. Token datacenter/ISP xoay có IP mới. Thiết bị riêng bắt đầu đổi IP.
{"error": "tooFrequent", "retryAfterSec": 4} Quá sớm sau lần đổi gần nhất. Hãy gửi lại sau retryAfterSec giây. Nếu không có retryAfterSec, liên kết đã được gọi hơn 20 lần trong một phút, hoặc một Thiết bị riêng vừa đổi IP chưa đầy một phút trước.
{"error": "noOtherIp"} Hiện không có IP nào khác trong vị trí đã lưu của token. Không có gì thay đổi, và thời gian chờ vẫn áp dụng.
{"error": "invalidKey"} Liên kết không tồn tại, hoặc token của nó đã hết hạn, bị tắt, hoặc nằm trong một gói không hoạt động.
{"error": "internalError"} Có lỗi ở phía chúng tôi. Hãy thử lại sau.