Bỏ qua đến nội dung chính

Quản lý danh sách residential

Đổi tên danh sách residential, thay đổi vòng xoay hoặc xóa nó qua API.

Hướng dẫn này cho biết cách đổi tên danh sách residential, thay đổi vòng xoay hoặc xóa nó.

Mỗi yêu cầu sử dụng khóa API cá nhân của bạn từ bảng điều khiển tài khoản (cách lấy khóa API). Trong các ví dụ dưới đây, hãy thay YOUR_API_KEY bằng khóa của bạn. Để thanh toán bằng số dư tài khoản, dùng paymentId = 1.

Bước 1 — Liệt kê các danh sách residential

Liệt kê các danh sách residential và sao chép id của cái cần quản lý.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists

Phản hồi

{
  "status": "success",
  "data": [
    { "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
  ],
  "errors": []
}

Bước 2 — Đổi tên danh sách

Đổi tên danh sách theo idtitle mới.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/rename

Nội dung yêu cầu

Tên

Loại

Mô tả

id

Number

ID danh sách.

title

String

Tên mới của danh sách.

Phản hồi

{
  "status": "success",
  "data": { "id": 561, "title": "New name" },
  "errors": []
}

Bước 3 — Thay đổi vòng xoay

Hoặc thay đổi vòng xoay danh sách theo id.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/rotation

Nội dung yêu cầu

Tên

Loại

Mô tả

id

Number

ID danh sách.

rotation

Number

Vòng xoay: -1 = sticky, 0 = mỗi yêu cầu, 1..3600 = giây.

Phản hồi

{
  "status": "success",
  "data": { "id": 561, "title": "New name" },
  "errors": []
}

Bước 4 — Hoặc xóa danh sách

Xóa danh sách theo id. Hành động này không thể hoàn tác.

Endpoint

DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/delete

Nội dung yêu cầu

Tên

Loại

Mô tả

id

Number

ID danh sách.

Phản hồi

{
  "status": "success",
  "data": { "deleted": true },
  "errors": []
}

Tài liệu API đầy đủ

Nội dung này có giải đáp được câu hỏi của bạn không?