360手机软件在线检测API.docx

360手机软件在线检测API版本1.1编写审核时间修订记录日期版本描述作者目录1.API接口格式32.分析结果格式33.示例4API接口格式合作方与360手机在线检测服务器之间，使用标准Http协议通信。合作方通过Http Post方式，将需要检测的内容发送至360手机在线检测服务器。Http Post的URL格式如下所示：/ScanC?UserKey=XXXXXXXXReqType=PkgRspType=Sync。其中，UserKey: 合作方唯一Key值（注册时由360分配）ReqType: 请求类型。取值为：Pkg－表示检测单个软件。（post的内容为单个软件包）Blk－表示检测批量软件。（post的内容为一个zip格式压缩包，压缩包里是所有待检测的软件包）Url－表示Url地址检测。（post的内容为纯文本文件，文件的每行为单个软件的下载URL地址）RspType: 应答方式。取值为：Sync－表示同步方式，Server在Http Post的应答报文里显示结果。Async－表示异步方式，Server在Http Post的应答报文里只显示ok/error。通过合作方登记的邮件地址，将分析结果发送到邮箱。每个合作方，对应其唯一的允许权限图。例如，合作方A的权限图为：ReqTypeRspTypePkg AvailSync AvailBlk AvailAsync AvailUrl Avail合作方B的权限图为：ReqTypeRspTypePkg AvailSync AvailBlk AvailAsync AvailUrl Avail分析结果格式软件包分析结果为xml格式的纯文本，采用UTF-8编码。配置文件以files作为根节点，内部包含n个file节点（ReqType为Pkg时，n=1；ReqType为Blk和Url时，n=1）。每个file节点包含以下tag：tag名称含义state分析完成状态，取值为：1: 分析成功0: 分析失败name软件包的名称url对ReqType为Url的请求，其值为下载地址对ReqType为Pkg的请求，其值为空对ReqType为Blk的请求，其值为空size软件包的大小（单位：字节）type软件包类型（目前支持android安装包和symbian安装包），取值为：sis: Symbian安装包apk: Android安装包etc: 其它类型包sign软件检测结果描述，取值为：通过不通过审核中desc附加描述信息示例如下：?xml version=1.0 encoding=UTF-8?filesfilestate1/statename360MobileSafe.apk/nameurl/urlsize1255670/sizetypeapk/typesign通过/signdesc/descfile/files示例要求：合作方系统为Uinx/Linux，支持curl命令工具。在命令行，执行如下的命令检测软件（可集成入shell脚本）：#curl -F file=@/360onlinescan/apk/xxxx.apk -o/360onlinescan/apk/xxxx.apk.xml“/ScanC?UserKey=XXXXXXXXReqType=PkgRspType=Sync”