点动云ARM云手机服务器,OPEN API 开放接口

2022-03-06 15:31发布

OpenApi

简要描述

  • 1、获取设备信息

请求URL

  • http://ip:port/api/openserver/ddy/phoneInfo

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

page

int

0

页码

size

int

20

页大小

请求示例

  {

    "page": 0,

    "size": 100

  }

 

  说明:当id有值时,表示查询该id的信息,page, size字段可以缺省。

       id缺省时,表示查询指定页码的设备信息

返回示例

  {

    "code": 0,

    "errmsg":"success",

    "data": {

        "sum": 10,

        "page":0

        "phone":[{

            "id":"phone001",

            "name":"xxxx",

            "state":"online",

            "ip":"xxx.xxx.xxx.xx"

        }]

    }

  }

返回参数说明

参数名

类型

说明

state

string

设备状态,online:在线;offline:离线

简要描述

  • 2、获取设备分身信息

请求URL

  • http://ip:port/api/openserver/ddy/vaeInfo

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

int

0

分身编号

page

int

0

页码

size

int

20

页大小

请求示例

  {

    "page": 0,

    "size": 100

  }

 

  说明:当id有值, index缺省时,表示查询该id下所有分身的信息,page, size字段可以缺省。

        id有值,index也有值时,表象查询该id下对应分身的信息,page, size字段可以缺省。

        idindex缺省时, 表示查询指定页码的数据。

返回示例

  {

    "code": 0,

    "errmsg":"success",

    "data": {

        "sum": 10,

        "page":0

        "vae":[{

            "id":"phone001",

            "index": 0,

            "androidId":"319C158963C08B3A",

            "imei":"867778039615243",

            "manufacture": "HUAWEI",

            "brand": "HUAWEI",

            "model": "BLA-AL00",

            "mac": "8f:0c:3a:06:8b:b2",

            "latitude": "30.242514",

            "longitude": "120.14042",

        }]

    }

  }

返回参数说明

参数名

类型

说明

androidId

string

安卓ID,每次改机都会改变

latitude

string

纬度

longitude

string

经度

简要描述

  • 3、一键新机

请求URL

  • http://ip:port/api/openserver/ddy/newPhone

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

int


分身编号

brand

string

“*”

手机品牌 :vivo, HUAWEI,honor,   oppo ,xiaomi,meizu,OnePlus,samsung

sdk

string

“28”

安卓版本: 29: 安卓10,28:安卓9, 27:安卓8.1

请求示例

  {

    "id": "phone001",

    "index": 0

  }

返回示例

  {

    "code": 0,

    "errmsg":"success",

    "data":{

        "androidId":"319C158963C08B3A"

    }

  }

简要描述

  • 4、获取设备文件信息

请求URL

  • http://ip:port/api/openserver/ddy/filesInfo

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

int

0

分身编号

path

string


路径

请求示例

  {

    "id": "phone001",

    "index": 1,

    "path":"/media"

  }

返回示例

  {

    "code": 0,

    "errmsg":"success",

    "data": {

        "sum": 10,

        "file":[{

            "name":"text.txt",

            "type":"file"

        },{

            "name":"picture",

            "type":"folder"

        }]

    }

  }

返回参数说明

参数名

类型

说明

type

string

file: 文件;folder:文件夹

简要描述

  • 5、设备文件上传

请求URL

  • http://ip:port/api/openserver/ddy/filesUpload

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

int

0

分身编号

path

string


路径

url

string


待上传的文件url地址

filename

string


待上传的文件名称

请求示例

  {

    "id": "phone001",

    "index": 1,

    "path":"/media",

    "url":"http://xxxx/xxxx/xxx.apk",

    "filename":"xxx.apk"

  }

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 6、设备文件移动接口

请求URL

  • http://ip:port/api/openserver/ddy/filesMove

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

int

0

分身编号

source

string


源路径

target

string


目标路径

请求示例

  {

    "id": "phone001",

    "index": 1,

    "source":"/media/ddtest.mp4",

    "target":"/video/ddtest.mp4"

  }

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 7、设备文件删除接口

请求URL

  • http://ip:port/api/openserver/ddy/filesDelete

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

int

0

分身编号

path

string


待删除文件路径

请求示例

  {

    "id": "phone001",

    "index": 1,

    "path":"/media/ddtest.mp4"

  }

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 8、获取设备应用信息

请求URL

  • http://ip:port/api/openserver/ddy/appsInfo

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

aid

string


应用ID

请求示例

  {

    "id": "phone001"

  }

 

    说明:当aid缺省时,表示获取设备id中安装的所有第三方应用信息。

         id"*"时,表示获取所有设备中安装的第三方应用信息。

返回示例

  {

    "code": 0,

    "errmsg":"success",

    "data":{

        "app":[{

            "id":"com.sina.weibo",

            "name":"微博",

            "version":"8.5.10",

            "phone":"phone001"

        },{

            "id":"com.smile.gifmaker",

            "name":"{KS}",

            "version":"9.5.10",

            "phone":"phone001"       

        }]

    }

  }

简要描述

  • 9、获取设备应用状态

请求URL

  • http://ip:port/api/openserver/ddy/appsState

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

aid

string


应用ID

请求示例

  {

    "id": "phone001"

  }

 

    说明:当aid缺省时,表示获取设备id中所有第三方应用状态信息。

         id"*"时,表示获取所有设备中第三方应用状态信息。

返回示例

  {

    "code": 0,

    "errmsg":"success",

    "data":{

        "appstate":[{

            "id":"com.sina.weibo",

            "state":[{

                "index": 0,

                "state": "running"        // 在后台运行

            },{

                "index": 1,

                "state": "stopped"        // 未运行

            },{

                "index": 2,

                "state": "foreground"   // 在前台运行

            }],

            "phone":"phone001"

        },{

            "id":"com.smile.gifmaker",

            "state":[{

                "index": 0,

                "state": "running"        // 在后台运行

            },{

                "index": 2,

                "state": "foreground"   // 在前台运行

            }],

            "phone":"phone001"

        }]

    }

  }

简要描述

  • 10、设备应用安装

请求URL

  • http://ip:port/api/openserver/ddy/appsInstall

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

url

string


待安装应用url地址

md5

string


待安装应用md5校验值

请求示例

  {

    "id": "phone001"

    "url":"http://xxx/xxx/xxx.apk",

    "md5":"xxxx"

  }

 

    说明:当id"*"时,表示对所有在线设备安装该应用。

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 11、设备应用卸载

请求URL

  • http://ip:port/api/openserver/ddy/appsUninstall

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

aid

string


待卸载的应用ID

请求示例

  {

    "id": "phone001"

    "aid":"com.smile.gifmaker"

  }

 

    说明:当id"*"时,表示对所有在线设备安装该应用。

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 11、设备应用启动

请求URL

  • http://ip:port/api/openserver/ddy/appsLaunch

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

string


分身编号

aid

string


应用ID

请求示例

  {

    "id": "phone001"

    "index":1,

    "aid":"com.smile.gifmaker"

  }

 

    说明:当id"*"时,表示启动所有在线设备对应分身的应用。

         index"*"时,表示启动所有分身的应用。

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 12、设备应用停止

请求URL

  • http://ip:port/api/openserver/ddy/appsKill

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

int


分身编号

aid

string


应用ID

请求示例

  {

    "id": "phone001"

    "index":1,

    "aid":"com.smile.gifmaker"

  }

 

    说明:当id"*"时,表示停止所有在线设备对应分身的应用。

         index"*"时,表示停止所有分身的应用。

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 13、获取应用界面xml

请求URL

  • http://ip:port/api/openserver/ddy/getUixml

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

请求示例

  {

    "id": "phone001"

  }

返回示例

  {

    "code": 0,

    "errmsg":"success",

    "data":{

        "xml":"xml str"

    }

  }

简要描述

  • 14、获取设备截屏

请求URL

  • http://ip:port/api/openserver/ddy/snapshot

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

请求示例

  {

    "id": "phone001"

  }

返回示例

  {

    "code": 0,

    "errmsg":"success",

    "data":{

        "snapshot":"iVBORw0KGgoAAAANSUhEUgAAALIAAAAYCAYA"   // 图片base64编码格式

    }

  }

简要描述

  • 15、设备屏幕点击

请求URL

  • http://ip:port/api/openserver/ddy/screenPress

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

x

int


点击x坐标

y

int


点击y坐标

duration

int

0

点击时间(毫秒)

fixed

bool


是否取固定坐标

请求示例

  {

    "id": "phone001"

    "x": 100,

    "y": 300

  }

 

  说明:当fixed缺省,或者fixedfalse时,表示取控件坐标。当fixedtrue时,表示取屏幕绝对坐标。

       duration缺省,或者为0时,表示一次鼠标单击。

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 16、设备文本框输入

请求URL

  • http://ip:port/api/openserver/ddy/editInput

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

x

int


点击x坐标

y

int


点击y坐标

content

string


待输入的内容

fixed

bool


是否取固定坐标

请求示例

  {

    "id": "phone001"

    "x": 100,

    "y": 300,

    "content":"你好!"

  }

 

  说明:当fixed缺省,或者fixedfalse时,表示取控件坐标。当fixedtrue时,表示取屏幕绝对坐标。

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 17、设备屏幕滑动

请求URL

  • http://ip:port/api/openserver/ddy/screenSwipe

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

x1

int


起始x坐标

y1

int


起始y坐标

x2

int


结束x坐标

y2

int


结束y坐标

duration

int


滑动时间(毫秒)

fixed

bool


是否取固定坐标

请求示例

  {

    "id": "phone001"

    "x1": 100,

    "y1": 300,

    "x2": 200,

    "y2": 600,

    "duration": 500

  }

 

  说明:当fixed缺省,或者fixedfalse时,表示取控件坐标。当fixedtrue时,表示取屏幕绝对坐标。

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 18、设置定位信息

请求URL

  • http://ip:port/api/openserver/ddy/setLocation

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

string


分身编号

latitude

string


纬度,保留六位小数

longitude

string


经度,保留六位小数

请求示例

  {

    "id": "phone001"

    "index": 1,

    "latitude": "30.242514",

    "longitude": "120.14042"

  }

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }

简要描述

  • 19、分身系统还原

请求URL

  • http://ip:port/api/openserver/ddy/recovery

请求方式

  • POST

参数

参数名

必选

类型

默认值

说明

id

string


设备ID

index

string


分身编号

androidId

string


安卓ID

请求示例

  {

    "id": "phone001"

    "index": 1,

    "androidId": "319C158963C08B3A",

  }

返回示例

  {

    "code": 0,

    "errmsg":"success"

  }