Bỏ qua, tới nội dung chính

Khái niệm

Phiên bản và nhật ký thay đổi

Cách API Browlix thay đổi, báo trước 90 ngày cho thay đổi phá vỡ tương thích, header Deprecation và Sunset, mức tương thích của client và mọi phiên bản lược đồ.

Xem dạng Markdown

API có một phiên bản trên URL, /api/v1, và một phiên bản lược đồ đổi theo mỗi lần thay đổi hợp đồng được phát hành. Tài liệu khám phá (GET /api/v1) và mọi tool MCP đều mang phiên bản hiện tại.

Thay đổi không cần báo trước

  • Thao tác mới, đầu vào tuỳ chọn mới, trường mới trong phản hồi, giá trị enum mới, khoá details mới trong lỗi, phiên bản giao thức MCP mới.
  • Client phải bỏ qua trường không biết và coi giá trị enum lạ là "khác". SDK và output schema của MCP được viết theo cách đó.

Thay đổi phá vỡ tương thích

Gỡ hoặc đổi tên một thao tác hay một trường, đổi kiểu dữ liệu, hoặc đổi ý nghĩa của một giá trị là thay đổi phá vỡ tương thích.

  1. Thay đổi được báo trong nhật ký này ít nhất 90 ngày trước khi có hiệu lực, kèm thao tác thay thế nếu có.
  2. Từ lúc báo, mọi phản hồi của thao tác đó — thành công hay lỗi — mang Deprecation (RFC 9745, thời điểm báo), Sunset (RFC 8594, hạn cuối) và Link: <…/api-changelog>; rel="deprecation".
  3. Tài liệu OpenAPI đánh dấu thao tác deprecated: true kèm x-sunset; mô tả tool MCP bắt đầu bằng ngày hết hạn và _meta có browlix/deprecated.
  4. Tài liệu khám phá liệt kê mọi thao tác sắp ngừng ở versioning.deprecations.

Hãy theo dõi header Sunset trong log hoặc bài kiểm thử — đó là tín hiệu sớm nhất.

Tương thích

  • SDK TypeScript: từ 0.5.0 trở lên chạy được với phiên bản lược đồ hiện tại (đã chạy thử từng bản). Cần 0.6.0+ cho kiểu NodeNext/ESM, 0.8.0+ cho acquireSession, 0.9.0+ cho kiểu của phản hồi.
  • Phần mềm trên máy (worker) tự cập nhật; tính năng nào cần bản mới hơn được báo theo từng máy ở features.*.min_worker của devices.capabilities.
  • Thay đổi phá vỡ tương thích được báo trước ít nhất 90 ngày.

Nhật ký thay đổi

Phiên bảnNgàyThay đổiThao tác
2026-10-27.dv11-dv122026-10-27thêm: Typed replies: OpenAPI response schemas, MCP outputSchema and SDK reply types for workspace, profiles, sessions, bindings, devices and feedback. MCP protocol revision 2026-07-28 (stateless, server/discover) served next to 2025-11-25, 2025-06-18 and 2025-03-26. Deprecation/Sunset headers and client compatibility in the discovery document.—
2026-10-27.p9-app-leases2026-10-27thêm: App account bindings, app holds on sessions (acquire, renew, detach with fencing generations, keep-warm), the session event cursor and per-machine capabilities.devices.capabilities, bindings.list, bindings.create, bindings.update, bindings.delete, sessions.acquire, sessions.renew, sessions.detach, sessions.events
2026-10-27.p16-session-recover2026-10-27thêm: Settle a session whose end is uncertain from the API (previously only in the web app).sessions.recover
2026-10-27.p9-feedback2026-10-27thêm: Feedback tickets for people and AI agents: submit, list, read and comment.feedback.submit, feedback.list, feedback.get, feedback.comment
2026-10-26.p10-automation2026-10-26thêm: Automation: flows, runs and their targets, tasks, schedules and approvals.flows.list, flows.get, flows.run, runs.list, runs.get, runs.stop, runs.pause, runs.retry, run_targets.get, run_targets.resolve, tasks.list, tasks.run, schedules.list, schedules.set_state, approvals.list, approvals.decide
2026-10-26.p5-sync2026-10-26thêm: Profile data sync: overview, per-profile status, restore, release and data key rotation.sync.overview, profiles.sync.get, profiles.sync.restore, profiles.sync.release, data_keys.rotate
2026-10-26.p8-adspower2026-10-26thêm: Machines report the state of their AdsPower-compatible Local API.—
2026-10-26.p8-webhooks2026-10-26thêm: Signed webhooks (Standard Webhooks): endpoints, secret rotation, test events, delivery log and redelivery.webhooks.list, webhooks.create, webhooks.update, webhooks.rotate_secret, webhooks.delete, webhooks.test, webhooks.deliveries, webhooks.redeliver
2026-10-26.p8-mcp2026-10-26thêm: MCP server on the same operations, and the OpenAPI document.openapi.get
2026-10-25.p4-usage2026-10-25thêm: Workspace usage and limits; sessions.start answers QUOTA_EXCEEDED at the concurrent-session limit.usage.get
2026-10-25.p4-prefs2026-10-25thêm: Versioned browser preference templates.preference_templates.list, preference_templates.get, preference_templates.create, preference_templates.publish, preference_templates.update, preference_templates.upgrade_profiles
2026-10-25.p42026-10-25thêm: Machines and browser sessions: start, stop and short-lived attach tickets.devices.list, sessions.list, sessions.get, sessions.start, sessions.stop, sessions.attach
2026-10-25.p22026-10-25thêm: Profiles, groups, tags and proxies.profiles.list, profiles.get, profiles.create, profiles.update, profiles.trash, profiles.restore, groups.list, groups.create, tags.list, tags.create, proxies.list, proxies.get, proxies.create, proxies.update, proxies.delete
2026-10-25.p12026-10-25thêm: API v1: workspace, members, invites, audit events and command receipts.discovery.get, workspace.get, workspace.rename, members.list, invites.create, audit.list, receipts.get

Ngừng hỗ trợ. Hiện không có thao tác nào đang trong thời gian ngừng hỗ trợ.