Tài Liệu API
Giới thiệu API OneChanger
OneChanger cung cấp hệ thống API mạnh mẽ giúp bạn tích hợp sâu vào các hệ thống automation. Điều khiển thay đổi thông tin thiết bị, backup, restore và cấu hình mạng một cách tự động.
Base URL Default: http://localhost:[PORT] (Mặc định: 9999)
1.API Random & Change Info
GET
/change
Random thông tin thiết bị mới và apply vào máy.
Cấu trúc URL cơ bản
http://localhost:[PORT]/change?serial=[PHONE_SERIAL]Cấu trúc URL đầy đủ tham số
http://localhost:[PORT]/change?serial=[PHONE_SERIAL]&filter_brand=[BRAND]&filter_model=[MODEL]&filter_os=[OS]&filter_country=[COUNTRY_CODE]&filter_carrier=[CARRIER]&custom_carrier=[CARRIER_NAME|SIMCODE]&lat=[LAT]&long=[LONG]&factory_reset=[OPTION]Parameters
| Parameter | Type | Description |
|---|---|---|
| serial | Required | Serial number của thiết bị cần change. |
| filter_brand | Opt | Lọc device theo Hãng (Brand). Ví dụ: google, samsung. |
| filter_model | Opt | Lọc theo Model. Khoảng trắng dùng %20. Ví dụ: Pixel%203a%20XL. |
| filter_os | Opt | Lọc theo phiên bản Android. Ví dụ: 10, 11, 12. |
| filter_country | Opt | Lọc theo Quốc gia (ISO code). Nếu chỉ có tham số này, tool sẽ random nhà mạng thuộc quốc gia đó. |
| filter_carrier | Opt | Lọc theo Nhà mạng cụ thể. Bắt buộc phải đi kèm filter_country. |
| custom_carrier | Opt | Nhà mạng tự nhập. Định dạng: Tên_nhà_mạng|Simcode. Ví dụ: T-Mobile|310160. Bắt buộc phải có filter_country đi cùng. |
| lat, long | Opt | Dùng cho việc fake location theo tọa độ tùy chọn. |
| factory_reset | Opt | Chế độ factory reset sẽ gỡ hết app do người dùng cài đặt, xóa hết dữ liệu trong phone. Giá trị: True hoặc False. |
Ví dụ a: Chỉ lấy device info của Google
GET http://localhost:9999/change?serial=1234567890&filter_brand=google
Ví dụ b: Chỉ lấy device Pixel 3a XL
GET http://localhost:9999/change?serial=1234567890&filter_model=Pixel%203a%20XL
Ví dụ c: Fake random nhà mạng theo country US
GET http://localhost:9999/change?serial=1234567890&filter_country=us
Ví dụ d: Chọn carrier Mineo thuộc country JP
GET http://localhost:9999/change?serial=1234567890&filter_country=jp&filter_carrier=Mineo-10
Ví dụ e: Change info với location tùy chọn
GET http://localhost:9999/change?serial=1234567890&lat=12.345678&long=23.4567890
Ví dụ f: Fake device info với nhà mạng T-Mobile của US (Custom Carrier)
GET http://localhost:9999/change?serial=1234567890&filter_country=us&custom_carrier=T-Mobile|310160
2.API Backup & Restore
GET
/backup
Tạo bản sao lưu dữ liệu (Backup) cho thiết bị.
http://localhost:[PORT]/backup?serial=[PHONE_SERIAL]¬e=[NOTE]&packages=[PACKAGES]
Parameters
| Parameter | Type | Description |
|---|---|---|
| serial | Required | Serial number của thiết bị. |
| note | Opt | Ghi chú cho file backup. |
| packages | Opt | Danh sách package muốn backup (cách nhau bởi dấu phẩy). Ví dụ: com.facebook.katana. |
Ví dụ: Backup với ghi chú và chọn app
GET http://localhost:9999/backup?serial=1234567890¬e=backup_fb&packages=com.facebook.katana
GET
/restore
Khôi phục dữ liệu từ file backup.
http://localhost:[PORT]/restore?serial=[PHONE_SERIAL]&backup_file=[FILENAME]
http://localhost:[PORT]/restore?serial=[PHONE_SERIAL]&gmail=[EMAIL]
Parameters
| Parameter | Type | Description |
|---|---|---|
| serial | Required | Serial number của thiết bị. |
| backup_file | Opt | Tên file backup cần restore (lấy từ API /getlist). Bắt buộc nếu không dùng gmail. |
| gmail | Opt | Hoặc dùng Gmail để tìm file backup chứa gmail đó. Bắt buộc nếu không dùng backup_file. |
Ví dụ: Restore theo tên file
GET http://localhost:9999/restore?serial=1234567890&backup_file=OneChanger_850fb27c...
GET
/getlist
Lấy danh sách các file backup hiện có.
http://localhost:[PORT]/getlist
REQUEST EXAMPLE
GET http://localhost:9999/getlist
3.API Network (SOCKS5)
GET
/configSock
Cấu hình Proxy/Socks cho thiết bị.
http://localhost:[PORT]/configSock?serial=[SERIAL]&sock=[IP:PORT]
Parameters
| Parameter | Type | Description |
|---|---|---|
| serial | Required | Serial number. |
| sock | Required | Thông tin Socks (IP:PORT hoặc IP:PORT:USER:PASS). |
| change_location | Opt | True/False. Fake GPS theo IP của sock. |
| change_timezone | Opt | True/False. Đổi múi giờ theo IP của sock. |
| change_webrtc | Opt | True/False. Ẩn/Hiện WebRTC. |
REQUEST EXAMPLE
GET http://localhost:9999/configSock?serial=1234567890&sock=192.168.1.10:8000&change_location=true
GET
/currentSock
Xem thông tin Socks đang cấu hình.
http://localhost:[PORT]/currentSock?serial=[SERIAL]
REQUEST EXAMPLE
GET http://localhost:9999/currentSock?serial=1234567890
GET
/changeInfoByCurrentIP
Cập nhật Timezone, Location theo IP public hiện tại (không reset máy).
http://localhost:[PORT]/changeInfoByCurrentIP?serial=[SERIAL]
REQUEST EXAMPLE
GET http://localhost:9999/changeInfoByCurrentIP?serial=1234567890
4.API update intergrity fix
GET
/updateintegrityfix
Update IntergrityFix
http://localhost:[PORT]/updateintegrityfix?serial=[SERIAL]
Parameters
| Parameter | Type | Description |
|---|---|---|
| serial | Required | Serial number. |
REQUEST EXAMPLE
GET http://localhost:9999/installApk?serial=1234567890
5.Tiện ích khác
GET
/installApk
Cài đặt APK từ máy tính vào điện thoại.
http://localhost:[PORT]/installApk?serial=[SERIAL]&path=[PATH_TO_APK]
Parameters
| Parameter | Type | Description |
|---|---|---|
| serial | Required | Serial number. |
| path | Required | Đường dẫn tuyệt đối tới file APK trên máy tính. |
REQUEST EXAMPLE
GET http://localhost:9999/installApk?serial=1234567890&path=D:\App\facebook.apk