相关教程


HTTP API 使用说明

1.所有接口返回值都是json格式,例如{"version":"1.0.1","code":0},code字段不为0则调用出错,返回数据请自行调用查看. 2.端口固定为8080,请先排除本地端口占用,导致http服务无法开启. 3.setcurrentrecordparam使用前先设置参数在/var/mobile/ctwparams.txt文件中 4.需要ID的接口可以修改记录名后使用getbakidfromname接口获取ID后再调用.

接口列表

以客户端的IP为准,这里使用127.0.0.1举例

OpenURL指令说明:

功能 代码
启动应用 openURL("CTW://?cmd=open");
一键新机 openURL("CTW://?cmd=newrecord");
下一条记录 openURL("CTW://?cmd=nextrecord");
清除所有记录 openURL("CTW://?cmd=deleteallrecords");
生效指定记录 openURL("CTW://?cmd=activerecord&ID=");
生效第一条 openURL("CTW://?cmd=activefirstrecord");
生效最后一条 openURL("CTW://?cmd=activelastrecord");
删除指定记录 openURL("CTW://?cmd=deleterecord&ID=");
直接导入记录 openURL("CTW://?cmd=importdirect");
导入记录放在/var/mobile/Media/CTWImport/下  

| | 导出指定记录 | openURL("CTW://?cmd=exportrecord&ID="); 导出记录在/var/mobile/Media/CTWExport/下 | | 导出所有记录 | openURL("CTW://?cmd=exportallrecords"); 导出记录在/var/mobile/Media/CTWExport/下 | | 重命名当前记录 | openURL("CTW://?cmd=renamecurrentrecord&name="); 重命名记录名。注:中文请使用URL编码。 | | 记录名查ID | openURL("CTW://?cmd=getbakidfromname&name="); 根据记录名查ID | | 获取当前记录参数 | openURL("CTW://?cmd=getcurrentrecordparam"); 获取的参数在/var/mobile/ctwparams.txt文件中 | | 设置当前记录参数 | openURL("CTW://?cmd=setcurrentrecordparam"); 设置的参数在/var/mobile/ctwparams.txt文件中。1.5.2以后不在支持,请查看帮助文档中通过客户识别码下发自定义参数的描述。 | | 启用禁用APP | openURL("CTW://?cmd=enablerecordapp"); 设置参数bid=bundle id,参数enable=1或0是否启用 | | 获取所有记录名列表 | openURL("CTW://?cmd=getallrecordsname"); 获取的记录名列表在/var/mobile/ctwrecords.txt文件中 | | 修改GPS定位 | openURL("CTW://?cmd=relocationwithbid"); 设置参数x,y,z,r,bid - 经纬度,海拔,随机范围,bundle id | | 下载二维码分享的配置 | openURL("CTW://?cmd=loadcloudconfig&device_id="); 参数为分享的设备ID |

指令返回值说明:

返回值在:/var/mobile/ctwresult.txt文件中

返回值 说明
0 指令执行正常完成。
1 指令执行出错。
2 指令正在执行过程中,还未完成。
4 下一条记录已到最后一条(仅针对nextrecord指令)。

ctwparams.txt参数文件说明:

获取或设置当前记录参数在:/var/mobile/ctwparams.txt文件中; 每一行一个参数,换行符为: chr(10); 参数名与参数值之间,使用冒号(:)隔开; 可通过调用指令getcurrentrecordparam后,打开该文件查看格式。

参数名称 说明
RecordID 记录ID,如:"微信001"。
RecordName 记录名,默认自动生成。
DeviceName 设备名称,如:"xxxx iPhone"。
SystemVersion 系统版本号,如:"10.3.1"。
IDFA IDFA值。
IDFV IDFV值。
UDID 设备UDID值。
IMEI 设备IMEI值。
SerialNum 设备序列号。
MAC MAC地址。
SSID SSID值。
BSSID BSSID值。

触动脚本示例:

URI编码函数:function encodeURl(s) s = string.gsub(s, "([^ %w%.%- ])", function(c) return string.format("%%%02X(",string.byte(c)) end) return string.gsub(s, " ","+") end
生效指定记录:recordld = encodeURI("1458774551"); url = string.format("CTW://?cmd=activerecord&ID=%s",
重命名当前记录:recordld = encodeURI("1458774551"); url = string.format("CTW://?cmd=renamecurrentrecord&name=%s" , recordld); openURL(url);
启动应用:openURL("CTW:/ /?cmd=open");