Skip to content

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_count
    • failed_count
    • failed_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"}

Last updated: