# Sửa đổi thông tin proxy

Cập nhật một cấu hình proxy.
- **Điều kiện tiên quyết**: proxy phải tồn tại trong nhóm. **Không thể cập nhật proxy động** qua endpoint này. Nhà cung cấp phải là một giá trị được nhận diện.
- **Tác động**: đây là ghi đè toàn bộ, không phải cập nhật từng phần — các trường bạn bỏ trống sẽ trở về giá trị mặc định chứ không giữ giá trị hiện tại. Hãy đọc proxy ra trước rồi gửi lại đầy đủ.
- **Phạm vi áp dụng**: các profile vẫn giữ liên kết vì chỉ bản ghi proxy thay đổi, nhưng một trình duyệt hoặc cloud phone đang chạy vẫn tiếp tục dùng thông tin kết nối mà nó đã khởi động cùng. Hãy khởi động lại nó để áp dụng thông tin mới.
- **Hoàn tất**: đồng bộ. Không có khóa lạc quan, nên các lần cập nhật đồng thời sẽ lấy lần ghi cuối cùng.

Các mã lỗi nghiệp vụ đã ghi nhận: `14003`, `14023`. Xem [Error Codes](../Getting%20Started/error-codes.md) để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Endpoint: POST /api/proxyInfo/update
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    ID ủy quyền duy nhất

  - `proxyIp` (string, required)
    Địa chỉ IP của máy chủ proxy

  - `proxyPort` (integer, required)
    Cổng máy chủ proxy

  - `proxyName` (string)
    Tên tùy chỉnh cho máy chủ proxy

  - `country` (string)
    Quốc gia (ví dụ: "Mỹ", "Trung Quốc")

  - `city` (string)
    Tên thành phố

  - `username` (string)
    Tên người dùng xác thực (nếu cần)

  - `password` (string)
    Mật khẩu xác thực (nếu cần)

  - `proxyType` (integer)
    Loại giao thức proxy:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH

  - `proxyProvider` (integer, required)
    Mã định danh nhà cung cấp proxy:
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH
- `4` = Oxylabs
- `5` = Proxys.io
- `6` = GeoSurf
- `7` = Luminati
- `8` = Lumauto
- `9` = Oxylabsauto
- `10` = Trojan
- `11` = Shadowsocks
- `12` = vmess
- `13` = ABCPROXY
- `14` = LunaProxy
- `15` = IPHTML
- `16` = PiaProxy
- `17` = 922S5

  - `encryptionType` (integer)
    Loại mã hóa (tùy thuộc vào nhà cung cấp, thường là 0 cho dạng văn bản thuần)

  - `ipMonitor` (boolean)
    Bật tính năng giám sát thay đổi địa chỉ IP

  - `ipChangeAction` (integer)
    Hành động cần thực hiện khi địa chỉ IP thay đổi:
- `1` = Thông báo / Làm mới (giá trị thông thường)

> Kiểm tra tài liệu hệ thống để biết đầy đủ các tùy chọn.

  - `refreshUrl` (string)
    URL để kích hoạt làm mới địa chỉ IP (nếu nhà cung cấp hỗ trợ)

  - `state` (string)
    Trường dành riêng hoặc trạng thái tùy chỉnh (tùy chọn)

## Response 200 fields (application/json):

  - `code` (integer, required)
    Mã trả về 0: Bình thường. Các mã khác là ngoại lệ.

  - `msg` (string | null, required)
    Thông báo lỗi

  - `requestId` (string, required)
    ID yêu cầu vận hành