Tài khoản
Tài khoản Zalo, Facebook, Telegram trên máy: danh sách, trạng thái, kết nối, proxy. · 10 endpoint
- GET/accounts
- GET/accounts/{accountId}
- GET/accounts/{accountId}/status
- POST/accounts/{accountId}/connect
- POST/accounts/{accountId}/disconnect
- GET/accounts/{accountId}/proxy
- PUT/accounts/{accountId}/proxy
- GET/proxies
- GET/accounts/{accountId}/zalo/settings
- PATCH/accounts/{accountId}/zalo/settings
Danh sách tài khoản (Zalo, Facebook, Telegram) mà key được phép
GET
/api/v1/accountsScope: accounts:readTham số
channelquery · tuỳ chọn | "zalo" | "facebook" | "telegram_user" | "telegram_bot" | Lọc theo kênh |
onlinequery · tuỳ chọn | boolean | Chỉ tài khoản đang online |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/accounts" \
-H "Authorization: Bearer dpk_xxx"Thông tin một tài khoản
GET
/api/v1/accounts/{accountId}Scope: accounts:readTham số
accountIdpath · bắt buộc | string max 200 | ID tài khoản (accounts.zalo_id). Facebook dùng Facebook ID, Telegram dùng ID tài khoản Telegram. |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/accounts/{accountId}" \
-H "Authorization: Bearer dpk_xxx"Trạng thái kết nối/listener chi tiết và proxy đang dùng
GET
/api/v1/accounts/{accountId}/statusScope: accounts:readTham số
accountIdpath · bắt buộc | string max 200 | ID tài khoản (accounts.zalo_id). Facebook dùng Facebook ID, Telegram dùng ID tài khoản Telegram. |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/accounts/{accountId}/status" \
-H "Authorization: Bearer dpk_xxx"Kết nối lại tài khoản bằng phiên đã lưu
POST
/api/v1/accounts/{accountId}/connectScope: accounts:manageDùng phiên đăng nhập đã lưu trên máy (không nhận cookie từ client). Zalo: login:connect; Facebook: fb:connect; Telegram: telegramUser:startListener.
Tham số
accountIdpath · bắt buộc | string max 200 | ID tài khoản (accounts.zalo_id). Facebook dùng Facebook ID, Telegram dùng ID tài khoản Telegram. |
Lệnh mẫu
bash
curl -X POST "http://127.0.0.1:9900/api/v1/accounts/{accountId}/connect" \
-H "Authorization: Bearer dpk_xxx"Ngắt kết nối tài khoản (giữ dữ liệu)
POST
/api/v1/accounts/{accountId}/disconnectScope: accounts:manageTham số
accountIdpath · bắt buộc | string max 200 | ID tài khoản (accounts.zalo_id). Facebook dùng Facebook ID, Telegram dùng ID tài khoản Telegram. |
Lệnh mẫu
bash
curl -X POST "http://127.0.0.1:9900/api/v1/accounts/{accountId}/disconnect" \
-H "Authorization: Bearer dpk_xxx"Proxy đang gán cho tài khoản (không trả mật khẩu)
GET
/api/v1/accounts/{accountId}/proxyScope: accounts:manageTham số
accountIdpath · bắt buộc | string max 200 | ID tài khoản (accounts.zalo_id). Facebook dùng Facebook ID, Telegram dùng ID tài khoản Telegram. |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/accounts/{accountId}/proxy" \
-H "Authorization: Bearer dpk_xxx"Gán proxy (id trong danh sách proxy) hoặc bỏ proxy (null)
PUT
/api/v1/accounts/{accountId}/proxyScope: accounts:manageTham số
accountIdpath · bắt buộc | string max 200 | ID tài khoản (accounts.zalo_id). Facebook dùng Facebook ID, Telegram dùng ID tài khoản Telegram. |
Body (JSON)
proxy_idbắt buộc | integer | null | ID proxy từ GET /proxies; null = bỏ proxy |
Lệnh mẫu
bash
curl -X PUT "http://127.0.0.1:9900/api/v1/accounts/{accountId}/proxy" \
-H "Authorization: Bearer dpk_xxx" \
-H "Content-Type: application/json" \
-d '{"proxy_id":0}'Danh sách proxy đã cấu hình (không trả mật khẩu)
GET
/api/v1/proxiesScope: accounts:manageLệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/proxies" \
-H "Authorization: Bearer dpk_xxx"Cài đặt quyền riêng tư của tài khoản Zalo
GET
/api/v1/accounts/{accountId}/zalo/settingsScope: accounts:readĐọc trực tiếp từ Zalo (như Cài đặt → Tài khoản → Quyền riêng tư Zalo). Mỗi mục: key (dùng khi đổi), value hiện tại (null = Zalo không trả), các lựa chọn hợp lệ. two_factor_enabled chỉ đọc.
Tham số
accountIdpath · bắt buộc | string max 200 | ID tài khoản (accounts.zalo_id). Facebook dùng Facebook ID, Telegram dùng ID tài khoản Telegram. |
Lệnh mẫu
bash
curl "http://127.0.0.1:9900/api/v1/accounts/{accountId}/zalo/settings" \
-H "Authorization: Bearer dpk_xxx"Đổi một cài đặt quyền riêng tư Zalo
PATCH
/api/v1/accounts/{accountId}/zalo/settingsScope: accounts:manageMỗi lần một mục, như app Zalo. key theo danh sách của GET; value thuộc lựa chọn của mục đó. Chú ý: receive_message = 2 hoặc accept_stranger_call = 2 (chỉ bạn bè) chặn khách chưa kết bạn nhắn / gọi.
Tham số
accountIdpath · bắt buộc | string max 200 | ID tài khoản (accounts.zalo_id). Facebook dùng Facebook ID, Telegram dùng ID tài khoản Telegram. |
Body (JSON)
keybắt buộc | string max 64 | |
valuebắt buộc | integer |
Lệnh mẫu
bash
curl -X PATCH "http://127.0.0.1:9900/api/v1/accounts/{accountId}/zalo/settings" \
-H "Authorization: Bearer dpk_xxx" \
-H "Content-Type: application/json" \
-d '{"key":"string","value":0}'