/api/public/v1/profiles/{id}/accept-egress-changeprofiles.accept_egress_change
profiles.accept_egress_change — Chấp nhận vị trí ra mạng mới mà bộ chốt đo được (egress.pending): vị trí này thành mốc mới và hồ sơ mở lại được; múi giờ chỉ đổi khi timezone=follow.
Tham số
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
idpath | string (uuid) | Có | ID hồ sơ |
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 |
expected_revisionbody | integer | Có | Bản sửa đổi đã đọc; trả CONFLICT nếu máy chủ có bản mới hơn (tối thiểu 1, tối đa 9007199254740991) |
timezonebody | "keep" | "follow" | Có | keep: giữ nguyên múi giờ của hồ sơ; follow: múi giờ tự đặt chuyển sang múi giờ của nơi ra mạng mới (múi giờ theo proxy thì không cần đổi) |
Ví dụ
curl -X POST "https://browlix.com/api/public/v1/profiles/<id>/accept-egress-change" \
-H "Authorization: Bearer $BROWLIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"command_id":"<uuid>","expected_revision":1,"timezone":"keep"}'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ả |
|---|---|---|---|
| data | object | Có | |
| data.profile_id | string (uuid) | Có | |
| data.revision | integer | Có | (tối thiểu -9007199254740991, tối đa 9007199254740991) |
| data.changed | array<string> | Có | egress_baseline, thêm config khi múi giờ đổi theo |
| data.baseline | object | Có | |
| data.baseline.ip | string | Không | |
| data.baseline.country | string | Không | Mã quốc gia ISO 3166-1 alpha-2 |
| data.baseline.timezone | string | Không | Múi giờ IANA của nơi ra mạng, khi worker xác định được |
| data.baseline.source | string | Không | first_launch (lần mở đầu tiên) | accepted (đã chấp nhận) |
| data.baseline.set_at | string (date-time) | Không | |
| data.baseline.observed_at | string (date-time) | Không | |
| correlation_id | string (uuid) | Có | |
| replayed | boolean | Không | true khi command_id này đã được áp dụng và trả lại biên nhận đã lưu |
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ó |
| DEPENDENCY_UNAVAILABLE | 503 | Có |
| UNKNOWN | 500 | Không |
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