Appearance
MOX API 文档 (只支持roothide ios16.x)
文档版本: 2026022001
基础信息
- Base URL:
http://IP:12309 - Content-Type:
application/json - 编码:
UTF-8
说明:
- 大多数业务错误会以
HTTP 200返回,并在 JSON 的code字段体现错误码。 - 仅少数情况会返回非 200(例如不存在路由可能是
404)。
API 列表
状态与鉴权
GET /status
- 说明: Daemon 运行状态
- 字段说明:
env为当前环境名称 - 请求参数: 无
data示例:
json
{
"message": "Operation succeed",
"data": {
"status": "running",
"env": "2026-02-20-00-34-51-47",
"timestamp": 1771583848.1417341
},
"code": 0
}环境参数
GET /get_env_param
- 说明: 获取当前环境参数
- 请求参数: 无
- 返回示例:
json
{
"message": "Operation succeed",
"data": {
"TimeZone": "America/Santo_Domingo",
"OutputVolume": "0.25",
"DiskSpace": "137438953472",
"RegionInfo": "B/A",
"ProductType": "iPhone15,5",
"SystemVer": "17.6.1",
"Brightness": "0.626",
"IDFA": "3DEE93DA-AAF6-41E9-AFCF-FBE0A916BF63",
"WifiAddress": "44:D9:E7:C5:02:09",
"Name": "iPhone",
"BSSID": "D8:38:FC:74:61:A3",
"UserAgent": "",
"SSID": "SpectrumSetup-84",
"IMEI": "577692352687892",
"BatteryLevel": "0.68",
"Language": "hr_BA",
"CarrierName": "O2-DE",
"DeviceToken": "e6f61360b4bd2998333e28447992dc077637eacf94b64a90f16f08700670a764",
"BuildVersion": "18G571",
"UDID": "c6e46c2e814a01755e0a2e304059d0437c72f4c9",
"Memory": "3221225472",
"SystemUptime": "960566",
"SerialNumber": "5KOQNIFHGQRM",
"BootUuid": "713EA831-2935-43DA-AE05-8B8EABE067EA",
"IDFV": "CE47E142-1656-4930-8176-ECAB5F31BC83",
"BatteryState": "1",
"BlueAddress": "60:31:97:1A:16:68",
"NetworkType": "CTRadioAccessTechnologyLTE"
},
"code": 0
}POST /update_env_param
- 说明: 更新环境参数(将参数写入环境配置)
- 请求体示例:
json
{
"TimeZone": "America/Santo_Domingo",
"OutputVolume": "0.25",
"DiskSpace": "137438953472",
"RegionInfo": "B/A",
"ProductType": "iPhone15,5",
"SystemVer": "17.6.2",
"Brightness": "0.626",
"IDFA": "3DEE93DA-AAF6-41E9-AFCF-FBE0A916BF63",
"WifiAddress": "44:D9:E7:C5:02:09",
"Name": "iPhone",
"BSSID": "D8:38:FC:74:61:A3",
"UserAgent": "",
"SSID": "SpectrumSetup-84",
"IMEI": "577692352687892",
"BatteryLevel": "0.68",
"Language": "hr_BA",
"CarrierName": "O2-DE2",
"DeviceToken": "e6f61360b4bd2998333e28447992dc077637eacf94b64a90f16f08700670a764",
"BuildVersion": "18G571",
"UDID": "c6e46c2e814a01755e0a2e304059d0437c72f4c9",
"Memory": "3221225472",
"SystemUptime": "960566",
"SerialNumber": "5KOQNIFHGQRM",
"BootUuid": "713EA831-2935-43DA-AE05-8B8EABE067EA",
"IDFV": "CE47E142-1656-4930-8176-ECAB5F31BC83",
"BatteryState": "1",
"BlueAddress": "60:31:97:1A:16:68",
"NetworkType": "CTRadioAccessTechnologyLTE"
}设备信息
GET /device_original_info
- 说明: 获取设备原始信息
- 请求参数: 无
目标 App 管理
GET /target_applist
- 说明: 获取可选目标 App 列表
备份与环境切换
GET /backup_list
- 说明: 获取备份列表
POST /backup_set_current
- 说明: 切换到指定备份环境
- 请求体:
json
{
"cur_dir": "env_20260220_001"
}POST /restore_original
- 说明: 恢复原始环境
POST /backup_rename
- 说明: 重命名备份
- 请求体:
json
{
"oldName": "env_old",
"newName": "env_new"
}POST /backup_batch_delete
- 说明: 批量删除备份
- 请求体:
json
{
"targetDirs": ["env_a", "env_b"]
}POST /import_list
- 说明: 导入备份列表(扫描导入目录)
POST /export_batch_list
- 说明: 批量导出备份
- 请求体:
json
{
"bakNames": ["env_a", "env_b"]
}- 返回
data可能包含:success_countfailed_countfailed_items
新建环境
POST /create_new_env
- 说明: 创建新环境(高耗时操作)
- 请求参数: 无
- 成功
data示例:
json
{
"operationSuccess": true,
"envID": "env_20260220_123456"
}定位相关
POST /fake_location
- 说明: 启动/停止模拟定位(CLSimulationManager 回放模式)
- 停止方式: 传空对象
{}或不传有效字段 - 启动请求示例:
json
{
"lat": 31.2304,
"lon": 121.4737,
"alt": 12.3,
"speed": 10.8
}- 成功返回
data:- 启动:
{"status":"started","mode":"replay_drift|replay_dynamic"} - 停止:
{"status":"stopped"}
- 启动:
字段说明:
lat/lon: 必填alt: 可选speed: 可选,单位 km/h(内部会换算 m/s)
POST /hook_location
- 说明: 更新 Hook 定位参
- 请求体示例:
json
{
"enable": true,
"latitude": 31.2304,
"longitude": 121.4737,
"altitude": 10.0,
"accuracy": 15.0,
"speed": 0.0,
"course": 0.0,
"pressure": 1013.25,
"relative_altitude": 0.2
}- 返回:
- 关闭时:
{"status":"disabled"} - 更新时:
{"status":"updated","mode":"hook_god_mode"}
- 关闭时: