/api/public/v1/workers/{id}/provision/previewworkers.provision_preview_request
workers.provision_preview_request — Yêu cầu ảnh trạng thái máy chính xác như UI; UNSUPPORTED nếu worker không hỗ trợ, BUSY khi có phiên.
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
idpath | string (uuid) | Có | ID máy |
command_idbody | string (uuid) | Có | UUID do chương trình khách tạo cho lệnh; gửi lại cùng id và nội dung để nhận biên nhận đã lưu; cùng id nhưng khác nội dung trả CONFLICT |
idempotency_keybody | string | Không | (độ dài tối thiểu 1, độ dài tối đa 163) |
actionbody | "apply" | "undo" | Có |
Ví dụ
curl -X POST "https://browlix.com/api/public/v1/workers/<id>/provision/preview" \
-H "Authorization: Bearer $BROWLIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"command_id":"<uuid>","action":"apply"}'Phản hồi
201 với { data, replayed: false, correlation_id } lần đầu; 200 với replayed: true khi cùng command_id và nội dung được gửi lại.
| Trường | Kiểu | Luôn có | Mô tả |
|---|---|---|---|
| operation_id | string (uuid) | null | Có | |
| state_version | integer | Có | (tối thiểu 0, tối đa 9007199254740991) |
| retryable | false | Có | |
| next | object | null | Có | |
| next.operation | "operations.get" | Có | |
| next.operation_id | string (uuid) | Có | |
| ok | true | Có | |
| data | object | Có |
Lỗi
| Mã | HTTP | Thử lại |
|---|---|---|
| UNAUTHENTICATED | 401 | Không |
| FORBIDDEN | 403 | Không |
| RATE_LIMITED | 429 | Có |
| VALIDATION_FAILED | 422 | Không |
| NOT_FOUND | 404 | Không |
| CONFLICT | 409 | Không |
| OUTCOME_UNKNOWN | 202 | Có |
| ACTION_OUTCOME_UNKNOWN | 202 | Không |
| IDEMPOTENCY_KEY_REUSED | 409 | Không |
| BUSY | 409 | Có |
| UNSUPPORTED | 501 | Không |
| DEPENDENCY_UNAVAILABLE | 503 | Có |
| UNKNOWN | 500 | Không |
Mọi thao tác
- GETlist
- GETget
- POSTcreate
- PATCHupdate
- POSTaccept_egress_change
- POSTtrash
- POSTrestore
- GETsync.get
- POSTsync.restore
- GETcleanup.preflight
- POSTcleanup.run
- GETcleanup.list
- POSTsync.release
- GETextensions
- GETbookmarks
- GETeffective_fingerprint
- GETnoise_status
- POSTnoise_upgrade
- GETdrift_list
- GETconsistency_report
- POSTcreate_from_context
- POSTdrift_accept
- GETexit_diagnostics
- POSTdrift_reject
Đang dùng AI agent?
Các tool Browlix có feedback_submit — sau khi dùng, báo lỗi, bất tiện hay câu hỏi chưa có lời đáp, mỗi vấn đề một lần.
Cách phản hồi hoạt động