目录

说明

所有接口信息的传递，皆适用UTF-8 字符集。

测试环境下配置，配置host信息如下：

10.127.3.246  server.findphone.com

一、用户身份注册（手机APP端）

功能说明：用于手机客户端的用户注册账号。

实现方式：HTTP请求，POST方式，传递Json串

参数名称 参数描述 备注

imei 手机串号 必须

mac 手机mac地址 必须

phone 机主号码

channel 渠道号

version 应用版本

package apk 包名

language 系统默认语言

region 国家地区

brand 手机品牌

display 分辨率

model 手机型号

manufacturer 手机制造商

hardware 硬件标识

cpu_abi Cpu标识

fingerprint 系统指纹

build_host 编译主机系统

build_date 制作者及制作时间

is_root 是否root

release 系统名称

sdk sdk版本

示例：

http://server.findphone.com/register.htm

“user”:{

“imei”:”1248584698547423”,

“mac”:” f8:a4:5f:8d:56:38”

“phone”:”15844125895”

…

}

返回值 返回值描述

code 100：上传成功

101：参数异常

102：程序业务逻辑异常

返回值示例：

二、其它接口说明

如下有server端提供服务的，也有client端提供服务的。

设Client地址前缀为http:// 10.6.35.117/

设Server地址前缀为http://security.changyou.com/

接口描述 接口示例 参数示例 方式 参数说明

用户注册 Server/cysecurity/reg-mobile

{

   umid: id,

   signkey: ssssssss,

   usr: uuuu,

   pwd:pppp,

   imei：xxxxxx,

mac: mmmmmm,

…

} POST 见上面表格

用户登录 Server/cysecurity/login-mobile

{

   umid:id,

   signkey: ssssssss,

   usr:uuuuu, 

   pwd:ppppp 

} POST Usr:用户名

Pwd：密码

通讯录备份 Server/cysecurity/adbook-backup

{

umid: id, 

signkey: ssssssss,

[

{Adid: adksjfkjdgd, Adop: insert, Addata: “data”}, 

…

]

} POST Adid：通讯录ID

Adop:对通讯录的操作（插入，删除，修改）

Addata：操作的数据

通讯录找回 Server/cysecurity/adbook-restore

{

umid: id, 

signkey: ssssssss,

[

“Addata”, 

…

]

} GET Addata：返回条目中的一条信息

短信备份 Server/cysecurity/sms-backup

[

umid: id, 

signkey: ssssssss,

{smsid: adksjfkjdgd, smsop: insert, smsata: “data”}, 

…

] POST Smsid：单条短信ID

Smsop: 短信操作（添加，删除）

Smsdata：单条短信

短信找回

Server/cysecurity/sms- restore 

{

  umid:id,

signkey: ssssssss,

[

Sms,

…

]

} GET Sms：单条短信内容

相册备份 Server/cysecurity/photo-backup

{

  umid:id,

signkey: ssssssss,

[

{phid: adksjfkjdgd, phop: insert, phdesc: “desc”}, 

…

],

}

[Phid: binary_data, …] POST Phid：操作的单个相片ID

Phop:对单个相片的操作（添加，删除）

Phdata：单个相片的描述

相片文件单独传送

相册找回

Server/cysecurity/photo-restore

{

umid:id,

signkey: ssssssss,

[

{phid：ppp,phdesc:ddd},

…

]

}

[{Phid: binary_data}, …] GET Phdesc:单个相片描述

Phid:单个相片ID

相片文件单独传送

通过网页查看通讯录 server/cysecurity/adbook-query

{

umid:id,

signkey: ssssssss,

[

“Addata”, 

…

]

} GET Addata：单条通讯录数据

通过网页查看短信 server/cysecurity/sms-query

{

umid:id,

signkey: ssssssss,

[

sms,

…

]

} GET 

Sms：单条短信数据

通过网页查看相册

server/cysecurity/photo-query

{

umid:id,

signkey: ssssssss,

[

{Phid:ppp,

phesc:dddd}

…

]

}

[{Phid: binary_data}, …] GET 

Phid:单个相片ID

Phdesc：单个相片描述

Web主动定位 client/cysecurity/position-query

{

umid:id,

signkey: ssssssss,

Long: 169, 

Lati: 39

} GET

Long:经度

Lati：纬度

Web锁定手机 client/cysecurity/phone-lock

{

umid:id,

signkey: ssssssss,

op: lock

} POST Op：操作

Web信息擦除手机

client/cysecurity/phone-erase

{

umid:id,

signkey: ssssssss,

op:erase

} POST 

Op：执行的操作

Web手机报警

client/cysecurity/phone-alarm

{

umid:id,

signkey: ssssssss,

op:alarm

} POST 

Op：执行的操作

三、数据库设计

1.图表示例

数据库说明

数据上传后账号信息分两份存储，一份存入Mysql，一份存入Mongodb，确保备份和安全。

其它信息为用户内容信息（SMS,AddrBook,Meta），这些内容信息存入Mongodb。

2.数据库设计

创建的库有User, SMS, Addr, Log,Meta

各个库的具体说明

库名 说明 用户 密码

User 用户账户库 mprotecter Mprotecter2014

SMS 用户短消息库 mprotecter Mprotecter2014

Addr 用户地址簿库 mprotecter Mprotecter2014

Log 所有日志存储库 mprotecter Mprotecter2014

3.数据库表设计

创建的表有Account, Message, AddrBook, Logs

MySql数据库中Account表设计：

字段名 数据类型 长度 主键 非空 描述

ID Int 15 是 非 自增ID

Time TimeStamp 非 存入时间

Usr Varchar 20 非 用户名

Pwd Char 32 非 密码

Umid Varchar 50 非 确定用户和设备的ID

Email Varchar 50 用户邮箱

Imei Char 15 非 手机imei号

Mac Char 48 非 手机mac号

Tel Varchar 20 手机号码

Mongodb中AddrBook表和Message表的设计：

AddrBook

{

contact_id:cccc,

tm:’2014-03-27 00:00:00’,

display_name:ddddd,

number:134856890,

number_type:1,

company:ccccc,

email:sdggg@dddd.com,

email_type:1,

last_time_contacted:’2014:03:14 00:00:00’,

addr:’ddddddddd’,

addr_type:1,

group:’dsds’,

group_title:’dgdgd’,

group_type:’d’

}

Message

{

sms_id:sssss,

tm: ‘2014-03-16 00:17:00’,

address:’ddddd’,

body:’dfdhfghghghfgfgfgfgdddddddd’,

date: ’2014:03:14 00:00:00’,

status:2,

type:3,

service_center:’sssssssss’,

sim_id:’86333844968’,

deleted:true

}

Meta

{

usr_id:sssss,

fid:’ffffffffffff’,

cpath: ‘2014-03-16 00:17:00’,

spath:’ddddd’,

cdate: ’2014:03:14 00:00:00’,

size:2,

perm:3

}