API tự động hóa cục bộ
Mở “API tự động hóa” ở thanh bên và nhấp “Khởi động API cục bộ”. Prism sẽ hiển thị địa chỉ API (một cổng ngẫu nhiên trên 127.0.0.1) và mã thông báo truy cập của phiên này; mã chỉ hiển thị một lần và mất hiệu lực khi dừng API.
| Yêu cầu | Chức năng |
|---|---|
| GET /v1/status | Trạng thái dịch vụ |
| GET /v1/profiles | Liệt kê hồ sơ: số thứ tự, tên, nhóm, thẻ, trạng thái, thời điểm mở gần nhất |
| GET /v1/profiles/{id}/status | Truy vấn trạng thái của một hồ sơ |
| POST /v1/profiles/{id}/start | Khởi chạy hồ sơ, với cùng bước kiểm tra proxy trước khi chạy và giới hạn chạy đồng thời như trên giao diện |
| POST /v1/profiles/{id}/close | Đóng hồ sơ |
| POST /v1/profiles | Tạo một hồ sơ, có thể đặt tên, nhóm, proxy và vân tay (từ bản 0.3.22) |
| POST /v1/profiles/batch | Tạo 1–50 hồ sơ mỗi lần, chỉ lưu khi tất cả đều hợp lệ (từ bản 0.3.22) |
curl -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles
curl -X POST -H "Authorization: Bearer $PRISM_TOKEN" http://127.0.0.1:$PRISM_PORT/v1/profiles/$PROFILE_ID/start- Chỉ chấp nhận yêu cầu từ chính máy này: Host phải khớp với địa chỉ API; yêu cầu có header Origin của trình duyệt hoặc tham số truy vấn sẽ bị từ chối (chỉ các endpoint tạo hồ sơ nhận thân yêu cầu JSON), nên trang web không thể gọi trực tiếp.
- Tối đa 120 yêu cầu mỗi phút (dùng chung với cầu nối MCP cục bộ).
- API có thể tạo, truy vấn, khởi chạy và đóng hồ sơ, nhưng không thể sửa hay xóa hồ sơ, cũng không thể đọc dữ liệu trình duyệt; bản thân API không cung cấp endpoint gỡ lỗi cho Puppeteer / Playwright (bản Windows mở một cổng gỡ lỗi ngẫu nhiên trên 127.0.0.1 để điều khiển nội bộ, đây không phải giao diện công khai).
- “Dừng khẩn cấp” sẽ đóng các hồ sơ do API khởi chạy; lịch sử gọi API được ghi vào nhật ký kiểm toán trên máy.
Xem quy tắc yêu cầu, các trường trả về, mã lỗi và ví dụ Python / Node.js trong tài liệu API cục bộ.
Tác vụ theo lịch cục bộ
| Thiết lập | Giá trị có thể chọn |
|---|---|
| Hành động | Khởi chạy hồ sơ / Đóng hồ sơ |
| Chế độ lặp lại | Một lần / Hàng ngày / Hàng tuần (có thể chọn nhiều ngày từ Chủ nhật đến Thứ bảy) |
| Thời gian thực hiện | Giờ và múi giờ của máy |
| Tác vụ bị lỡ | Chạy bù một lần trong vòng 24 giờ / Bỏ qua lần này |
| Thử lại khi thất bại | 0–3 lần, khoảng cách giữa các lần thử lại 1–60 phút |
- Tác vụ theo lịch chỉ thực thi khi Prism đang chạy, không có tiến trình thường trú chạy nền; cứ 15 giây kiểm tra các tác vụ đến hạn một lần, thực thi đồng thời tối đa 2 tác vụ.
- Có thể dùng “Chạy ngay” để thử tác vụ; hồ sơ đang được tác vụ theo lịch sử dụng phải được gỡ khỏi tác vụ trước khi có thể xóa.
- Khi giấy phép Pro mất hiệu lực, việc lập lịch tạm dừng; các tác vụ vẫn được giữ lại và bạn vẫn có thể tắt hoặc xóa chúng.
Ví dụ kết hợp
Tự động mở sẵn hồ sơ làm việc đầu ngày
Khởi chạy các hồ sơ thường dùng lúc 09:00 mỗi ngày và đóng chúng trước giờ tan làm, giảm thao tác thủ công và tránh mở nhầm.
Khởi chạy / đóng hàng loạt bằng script
Trong script của bạn, trước tiên gọi GET /v1/profiles để lấy ID hồ sơ, rồi khởi chạy lần lượt; logic khởi chạy giống hệt trên giao diện.
Để AI làm tiếp
Sau khi hồ sơ khởi chạy, MCP sẽ đọc trang và hoàn thành các bước tiếp theo trong những hồ sơ bạn đã cấp quyền.
Câu hỏi thường gặp
- Có thể chạy script tùy chỉnh hoặc quy trình RPA không?
- Tác vụ theo lịch chỉ hỗ trợ khởi chạy và đóng hồ sơ, API cũng không thực thi script. Khi cần thao tác ở cấp trang, bạn có thể dùng MCP của Pro hoặc tự cài tiện ích mở rộng trong hồ sơ.
- Có tương thích với API của các trình duyệt antidetect khác không?
- Không. Prism dùng API cục bộ riêng; các đường dẫn xem ở bảng trên.
- Tác vụ theo lịch có còn chạy sau khi đóng Prism không?
- Không. Tác vụ theo lịch cần Prism đang chạy; tác vụ bị lỡ có thể được chạy bù một lần trong vòng 24 giờ, tùy theo thiết lập.