API Tự động hóa

Mục lục

• 1. Điều kiện tiên quyết
• 2. Xác thực · hệ khoá
• 3. Chia sẻ gia đình (sub-account)
• 4. Trạng thái server
• 5. Chế độ Burst (chọn engine · random)
• 6. Phân nhánh response (Chromium vs Firefox)
• 7. Quản lý profile đã lưu
• 8. Chạy profile đã lưu
• 9. Quản lý session
• 10. Mã lỗi
• 11. Giới hạn · AUP

1. Điều kiện tiên quyết

• Ứng dụng máy tính v0.1.23 trở lên đang chạy, đã kích hoạt bằng khoá license (gắn với thiết bị)
• Gọi API tới chính PC đó tại http://127.0.0.1:9333 (Local API). Chỉ 127.0.0.1, chặn LAN
• Header X-API-Key với SDK API key (sk_…) — xem mục "SDK API Key" trên Trang của tôi
• Chỉ cần một thành viên gia đình (chính + phụ) kích hoạt App, khoá API dùng chung sẽ hoạt động

2. Xác thực · hệ khoá

Có 2 loại khoá — đừng nhầm lẫn:

Header chung

X-API-Key: sk_xxxxxxxx_yyyy
Content-Type: application/json

3. Chia sẻ gia đình (sub-account)

• SDK API key: 1 khoá chính — cả gia đình (chính + phụ) dùng chung (phụ không có sk_ riêng)
• Pool profile dùng chung — phụ đăng nhập vẫn xem/chạy profile của chính
• Hạn mức (maxProfiles) = gói của chính. Tổng chính + phụ không được vượt
• Thiết bị active: dù chính đã bỏ gắn, miễn còn 1 phụ active, API vẫn chạy
• Bỏ gắn thiết bị phụ: /account → bảng phụ → [Bỏ gắn thiết bị]