Hướng dẫn sử dụng API (new)

Chú ý: API này chỉ giành cho phiên bản hiện bản mới android 12L no root, những bản trước sẽ không dùng được, vui lòng xem lại api cho bản cũ nếu bạn đang sử dụng nó.

Khi change thiết bị thì sẽ thay đổi cả serial của thiết bị, vì vậy mỗi khi api thành công sẽ trả về serial mới của thiết bị vừa change, dùng nó để gọi api lần tiếp theo đối với thiết bị đó

Khi change xong vì sẽ change sạch nên mất wifi, proxy, anh em nên sử dụng api set proxy, set wifi để kết nối thiết bị cho thuận tiện công việc

1. Bật server api để sử dụng

Bật API server : Click vào nút "Start Server API"

Tắt API server : Click vào nút "Stop Server API"

Chú ý : Để đơn giản việc sử dụng API, các tùy chọn settings được sử dụng trực tiếp trên tool xprosoftware mà không thêm vào tham số api để tránh phức tạp. Nên mọi settings anh em có thể sử setup trên tool và sử dụng như khi dùng tool bình thường.

2. API change info

Trước khi bắt đầu sử dụng API Change Info cần chú ý sau:

• Để tìm kiếm chính xác tham số brand, country, operator thì nên tham khảo trực tiếp trên tool

URL format:

http://localhost:8080/changeinfo/SERIAL?brand=BRANDNAME&country=COUNTRY&operator=OPERATORNAME&typechange=option{normal|full}

Metod : GET

Params: "SERIAL" là mã seri của thiết bị, có thể lấy bằng cách gõ "adb devices" và mỗi lần thay đổi thiết bị bằng api sẽ trả về số seri này để sử dụng cho lần tiếp theo.

Query:

• "brand" là thương hiệu điện thoại như Google, Xiaomi, Samsung,.. có hỗ trợ trên tool.

• "model" là mã thiết bị như Pixel 3a, Pixel 3a XL, Pixel 5 (Google),... nên xem trên tool để chính xác trước khi chạy api.

• "country" là quốc gia muốn thay đổi như VN (việt nam), US (mỹ), GB (anh),... có hỗ trợ trên tool.

• "operator" là mã sim theo nhà mạng như 45204(viettel), 45202(vinaphone).... nên xem trên tool để chính xác trước khi chạy api.

• "sdk" là phiên bản android như 30 (android 11), 32 (android 12L), 33 (android 13)... khuyến nghị nên để android 12L (32) cùng bản với rom cho ổn định.

• "typechange" là loại change, mặc định là change thường chỉ xóa data app (cần bỏ package vào wipe package), nếu typechange=full thì sẽ xóa mọi dữ liệu trong máy.

Response format: {"success": true | false, "message": serial (serial đã thay đổi khi change của thiết bị)}

Trong đó:

• Thông số SERIAL là adb serial của device muốn change

• Các thông số BRANDNAME, COUNTRY, OPERATOR nhận giá trị như phần Random Info trong App PC

• Thông số "typechange" là loại change, mặc định là change normal là chỉ change xóa data app, nếu typechange=full thì là change full với reset factory

• Các thông số trên không cần nhập đầy đủ, những thông số không nhập sẽ nhận giá trị random, và typechange mặc định là normal

Ví dụ: Change device info với 3 thông số random:

http://localhost:8080/changeinfo/9CGAY1PE3N

Change device info với BRANDNAME=google và COUNTRY=US, OPERATOR = 310016 (phần này nên đối chiếu trên tool cho chính xác) với change normal xóa data app bình thường

http://localhost:8080/changeinfo/9CGAY1PE3N?brand=google&country=US&operator=310016

Change device info với BRANDNAME=google và COUNTRY=US, OPERATOR = 310016 (phần này nên đối chiếu trên tool cho chính xác) với typechange=full là change full reset factory

http://localhost:8080/changeinfo/9CGAY1PE3N?brand=google&country=US&operator=310016
&typechange=full

3. Backup app và change info

a. Backup chỉ với data

Trước khi bắt đầu sử dụng API Change Info cần chú ý sau:

• Backup chỉ với data thì phải yêu cầu bỏ gói package app vào Setting -> Backup data, mỗi app là 1 dòng package

• Để tìm kiếm chính xác tham số brand, country, operator thì nên tham khảo trực tiếp trên tool

URL format:

http://localhost:8080/backupappandchange/SERIAL?filename=<tên file>&brand=BRANDNAME&country=COUNTRY&operator=OPERATORNAME&typechange=option{normal|full}

Metod : GET

Params: "SERIAL" là mã seri của thiết bị, có thể lấy bằng cách gõ "adb devices" và mỗi lần thay đổi thiết bị bằng api sẽ trả về số seri này để sử dụng cho lần tiếp theo.

Query:

• "brand" là thương hiệu điện thoại như Google, Xiaomi, Samsung,.. có hỗ trợ trên tool.

• "model" là mã thiết bị như Pixel 3a, Pixel 3a XL, Pixel 5 (Google),... nên xem trên tool để chính xác trước khi chạy api.

• "country" là quốc gia muốn thay đổi như VN (việt nam), US (mỹ), GB (anh),... có hỗ trợ trên tool.

• "operator" là mã sim theo nhà mạng như 45204(viettel), 45202(vinaphone).... nên xem trên tool để chính xác trước khi chạy api.

• "sdk" là phiên bản android như 30 (android 11), 32 (android 12L), 33 (android 13)... khuyến nghị nên để android 12L (32) cùng bản với rom cho ổn định.

• "typechange" là loại change, mặc định là change thường chỉ xóa data app (cần bỏ package vào wipe package), nếu typechange=full thì sẽ xóa mọi dữ liệu trong máy.

Response format: {"success": true | false, "message": serial (serial đã thay đổi khi change của thiết bị)}

Trong đó:

• Thông số SERIAL là adb serial của device muốn change

• Tham số filename là tên để đặt cho file backup app

• Các thông số BRANDNAME, COUNTRY, OPERATOR nhận giá trị như phần Random Info trong App PC

• Thông số "typechange" là loại change, mặc định là change normal là chỉ change xóa app, nếu typechange=full thì là change full với reset factory

• Các thông số trên không cần nhập đầy đủ, những thông số không nhập sẽ nhận giá trị random.

Ví dụ: Backup 1 tài khoản amazon và đặt tên file là amazon1 với tham số typechange mặc định là normal, nghĩa là backup data app và change thiết bị chỉ xóa data app đã khai báo

http://localhost:8080/backupappandchange/9CGAY1PE3N?filename=amazon1&brand=google&country=US&operator=310016

Ví dụ: Backup 1 tài khoản amazon và đặt tên file là amazon1với tham số typechange=full, nghĩa là backup data app và change với reset factory đưa máy về như ban đầu.

http://localhost:8080/backupappandchange/9CGAY1PE3N?filename=amazon1&brand=google&country=US&operator=310016&typechange=full

b. Backup data + apk

Trước khi bắt đầu sử dụng API Change Info cần chú ý sau:

• Để tìm kiếm chính xác tham số brand, country, operator thì nên tham khảo trực tiếp trên tool

URL format:

http://localhost:8080/backupdataapkandchange/SERIAL?filename=<tên file>&brand=BRANDNAME&country=COUNTRY&operator=OPERATORNAME

Metod : GET

Params: "SERIAL" là mã seri của thiết bị, có thể lấy bằng cách gõ "adb devices" và mỗi lần thay đổi thiết bị bằng api sẽ trả về số seri này để sử dụng cho lần tiếp theo.

Query:

• "brand" là thương hiệu điện thoại như Google, Xiaomi, Samsung,.. có hỗ trợ trên tool.

• "model" là mã thiết bị như Pixel 3a, Pixel 3a XL, Pixel 5 (Google),... nên xem trên tool để chính xác trước khi chạy api.

• "country" là quốc gia muốn thay đổi như VN (việt nam), US (mỹ), GB (anh),... có hỗ trợ trên tool.

• "operator" là mã sim theo nhà mạng như 45204(viettel), 45202(vinaphone).... nên xem trên tool để chính xác trước khi chạy api.

• "sdk" là phiên bản android như 30 (android 11), 32 (android 12L), 33 (android 13)... khuyến nghị nên để android 12L (32) cùng bản với rom cho ổn định.

• "typechange" là loại change, mặc định là change thường chỉ xóa data app (cần bỏ package vào wipe package), nếu typechange=full thì sẽ xóa mọi dữ liệu trong máy.

Response format: {"success": true | false, "message": serial (serial đã thay đổi khi change của thiết bị)}

Trong đó:

• Thông số SERIAL là adb serial của device muốn change

• Tham số filename là tên để đặt cho file backup app

• Các thông số BRANDNAME, COUNTRY, OPERATOR nhận giá trị như phần Random Info trong App PC

• Thông số "typechange" là loại change, mặc định là change normal là chỉ change xóa app, nếu typechange=full thì là change full với reset factory

• Các thông số trên không cần nhập đầy đủ, những thông số không nhập sẽ nhận giá trị random

Ví dụ: Backup 1 tài khoản amazon và đặt tên file là amazon1 với tham số typechange mặc định là normal, nghĩa là backup data + apk và change thiết bị chỉ xóa data app đã khai báo

http://localhost:8080/backupdataapkandchange/9CGAY1PE3N?filename=amazon1&brand=google&country=US&operator=310016

Ví dụ: Backup 1 tài khoản amazon và đặt tên file là amazon1 với tham số typechange=full, nghĩa là backup data + apk và change với reset factory đưa máy về như ban đầu.

http://localhost:8080/backupdataapkandchange/9CGAY1PE3N?filename=amazon1&brand=google&country=US&operator=310016&typechange=full

c. Backup full thiết bị

Trước khi bắt đầu sử dụng API Change Info cần chú ý sau:

• Để tìm kiếm chính xác tham số brand, country, operator thì nên tham khảo trực tiếp trên tool

URL format:

http://localhost:8080/backupappfullandchange/SERIAL?filename=<tên file>&brand=BRANDNAME&country=COUNTRY&operator=OPERATORNAME

Metod : GET

Params: "SERIAL" là mã seri của thiết bị, có thể lấy bằng cách gõ "adb devices" và mỗi lần thay đổi thiết bị bằng api sẽ trả về số seri này để sử dụng cho lần tiếp theo.

Query:

• "brand" là thương hiệu điện thoại như Google, Xiaomi, Samsung,.. có hỗ trợ trên tool.

• "model" là mã thiết bị như Pixel 3a, Pixel 3a XL, Pixel 5 (Google),... nên xem trên tool để chính xác trước khi chạy api.

• "country" là quốc gia muốn thay đổi như VN (việt nam), US (mỹ), GB (anh),... có hỗ trợ trên tool.

• "operator" là mã sim theo nhà mạng như 45204(viettel), 45202(vinaphone).... nên xem trên tool để chính xác trước khi chạy api.

• "sdk" là phiên bản android như 30 (android 11), 32 (android 12L), 33 (android 13)... khuyến nghị nên để android 12L (32) cùng bản với rom cho ổn định.

• "typechange" là loại change, mặc định là change thường chỉ xóa data app (cần bỏ package vào wipe package), nếu typechange=full thì sẽ xóa mọi dữ liệu trong máy.

Response format: {"success": true | false, "message": serial (serial đã thay đổi khi change của thiết bị)}

Trong đó:

• Thông số SERIAL là adb serial của device muốn change

• Tham số filename là tên để đặt cho file backup app

• Các thông số BRANDNAME, COUNTRY, OPERATOR nhận giá trị như phần Random Info trong App PC

• Thông số "typechange" là loại change, mặc định là change normal là chỉ change xóa app, nếu typechange=full thì là change full với reset factory

• Các thông số trên không cần nhập đầy đủ, những thông số không nhập sẽ nhận giá trị random

Ví dụ: Backup 1 tài khoản amazon và đặt tên file là amazon1 với tham số typechange mặc định là normal, nghĩa là backup toàn bộ thiết bị và change thiết bị chỉ xóa data app đã khai báo

http://localhost:8080/backupappandchange/9CGAY1PE3N?filename=amazon1&brand=google&country=US&operator=310016

Ví dụ: Backup 1 tài khoản amazon và đặt tên file là amazon1 với tham số typechange=full, nghĩa là backup toàn bộ thiết bị và change với reset factory đưa máy về như ban đầu.

http://localhost:8080/backupappandchange/9CGAY1PE3N?filename=amazon1&brand=google&country=US&operator=310016&typechange=full

4. Restore app

URL format:

http://localhost:8080/restoreapp/SERIAL?filename=<tên file>&type=<data|apk|full>

Metod : GET

Response format: {"success": true | false, "message": serial (serial đã thay đổi khi change của thiết bị)}

Trong đó:

• Thông số SERIAL là adb serial của device muốn change

• Các thông số filename là tên file cần restore. (có thể lấy từ api get list backup)

• Thông số "type" là loại backup data, hay data + apk, hay full. mặc định là data. Trong list backup api trả về thì backupLite:true là loại file data+apk và backupNormal:true thì là loại data, và backupNormal:false và backupLite:false là full. Vì để bảo toàn phiên bản cũ nên hơi rắc rối, anh em để ý tí là được.

Ví dụ: Restore 1 file amazon đã backup trước đó

http://localhost:8080/restoreapp/9CGAY1PE3N?filename=amazon1&type=apk

5. Set proxy

URL format:

http://localhost:8080/setproxy/SERIAL?proxy=<host:port | host:port:user:pass>

Metod : GET

Response format: {"success": true | false, "message": serial}

Trong đó:

• Thông số SERIAL là adb serial của device muốn change

• Các thông số proxy là định dạng proxy cần thiết lập.

Ví dụ: Set proxy với 10.10.1.27:40000

http://localhost:8080/setproxy/9CGAY1PE3N?proxy=10.10.1.27:40000

6. Set wifi

URL format:

http://localhost:8080/setwifi/SERIAL?wifi=<name:pass>

Metod : GET

Response format: {"success": true | false, "message": serial}

Trong đó:

• Thông số SERIAL là adb serial của device muốn change

• Các thông số wifi là định dạng wifi cần thiết lập.

Ví dụ: Set wifi với tên wifi và mật khẩu wifi "xprosoftware:12345678"

http://localhost:8080/setwifi/9CGAY1PE3N?wifi=xprosoftware:12345678

7. Set location

URL format:

http://localhost:8080/setlocation/SERIAL?location=<lat:lon>&option=[fast|reboot]

Metod : GET

Response format: {"success": true | false, "message": serial}

Trong đó:

• Thông số SERIAL là adb serial của device muốn change

• Các thông số location là định dạng location cần thiết lập.

• Thông số option là tùy chọn, mặc định là fast, với fast thì set không cần reboot máy, nhưng khi bị reboot đt sẽ mất tác dụng, với reboot thì sẽ set chậm nhưng sẽ luôn ăn vào đt dù có reboot lại máy.

Ví dụ: Set location với lat và lon là "13.09800530461667:109.30912382617424" với mặc định là option = fast

http://localhost:8080/setlocation/9CGAY1PE3N?location=13.0980053:109.3091238

8. API lấy danh sách file backup có trong tool

URL format:

http://localhost:8080/getlistbackup

Metod : GET

Response format: {"success": true | false, "message": list}