Bỏ qua, tới nội dung chính
POST/api/public/v1/workers/{id}/provision/confirmed

workers.provision_confirmed

workers.provision_confirmed — Áp dụng hoặc hoàn tác đúng bản xem trước đã đồng ý qua RPC của UI; CONFLICT nếu cũ, FORBIDDEN nếu không phải chủ đồng ý, UNSUPPORTED khi chưa kiểm.

Quyền: device.manageLệnh (chống trùng)Tool MCP: workers_provision_confirmed
Xem dạng Markdown

Tham số

TênKiểuBắt buộcMô tả
idpathstring (uuid)CóID máy
command_idbodystring (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_keybodystringKhông(độ dài tối thiểu 1, độ dài tối đa 163)
actionbody"apply" | "undo"Có
consentbodytrueCó
preview_commandbodystring (uuid)Có
preview_tokenbodystringCó

Ví dụ

curl -X POST "https://browlix.com/api/public/v1/workers/<id>/provision/confirmed" \
  -H "Authorization: Bearer $BROWLIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command_id":"<uuid>","action":"apply","consent":true,"preview_command":"<preview_command>","preview_token":"<preview_token_64hex>"}'

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ườngKiểuLuôn cóMô tả
operation_idstring (uuid) | nullCó
state_versionintegerCó(tối thiểu 0, tối đa 9007199254740991)
retryablefalseCó
nextobject | nullCó
next.operation"operations.get"Có
next.operation_idstring (uuid)Có
oktrueCó
dataobjectCó

Trường mới có thể xuất hiện bất cứ lúc nào; hãy bỏ qua trường bạn không biết.

Lỗi

MãHTTPThử lại
UNAUTHENTICATED401Không
FORBIDDEN403Không
RATE_LIMITED429Có
VALIDATION_FAILED422Không
NOT_FOUND404Không
CONFLICT409Không
OUTCOME_UNKNOWN202Có
ACTION_OUTCOME_UNKNOWN202Không
IDEMPOTENCY_KEY_REUSED409Không
UNSUPPORTED501Không
DEPENDENCY_UNAVAILABLE503Có
UNKNOWN500Không

Mọi mã lỗi và khi nào nên thử lại

Mọi thao tác

Đ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