提示

如果您需要专业团队为您和您的企业订制全网互通的协作工具可以通过 cube#spap.com 或者 xujiangwei#spap.com （将“#”替换为“@”）邮箱联系我们。

Robot


自动任务

采集抖音账号基础数据

通过指定账号搜索关键字，通过搜索方式定位数据，读取搜索结果的账号数据。包括账号发布的作品信息。

  • 任务名称：

    DouYinAccountData

  • 参数说明：

    • word - 检索关键词

    • maxNumVideo - 采集视频作品的最大数量

  • 参数设置示例：

    JSONObject parameter = new JSONObject();
parameter.put("word", "光明网");
parameter.put("maxNumVideo", 10);

抖音日常操作

模拟日常刷抖音看视频操作。

  • 任务名称：

    DouYinDailyOperation

  • 参数说明：

    • duration - 操作需要执行总时长，单位：秒。


开放接口

注册回调

POST /robot/register/(code)

注册事件回调的 URL 链接。

Parameters

  • code (string) – 您申请的访问码。

Request Headers
Request JSON Object

  • url (string) – 回调的 URL 链接。

Status Codes

注销回调

POST /robot/deregister/(code)

注销事件回调的 URL 链接。

Parameters

  • code (string) – 您申请的访问码。

Request Headers
Request JSON Object

  • url (string) – 回调的 URL 链接。

Status Codes

获取在线设备列表

GET /robot/online/(code)

获取当前在线的设备列表。

Parameters

  • code (string) – 您申请的访问码。

Response Headers
Response JSON Object

  • total (number) – 在线设备总数。

  • list (Array) – 设备账号数据列表，参看 账号 数据结构。

Status Codes

获取账号数据

GET /robot/account/(code)

获取账号数据。

Parameters

  • code (string) – 您申请的访问码。

Response Headers
Response JSON Object

  • - (object) –

    账号数据，参看 账号 数据结构。

Status Codes

执行任务

POST /robot/perform/(code)

执行指定任务。可执行任务参看 自动任务 章节。

Parameters

  • code (string) – 您申请的访问码。

Request Headers
Request JSON Object

  • name (string) – 任务名称。

  • parameter (object) – 任务参数。

  • accountId (number) – 执行任务的设备账号。

Status Codes

取消任务

POST /robot/cancel/(code)

取消正在执行的任务。

Parameters

  • code (string) – 您申请的访问码。

Request Headers
Request JSON Object

  • accountId (number) – 执行任务的设备账号。

  • name (string) – 任务名称。

Status Codes

数据结构

账号

字段

类型

必填

默认值

描述

id

long

Y

–

账号 ID 。

name

string

Y

–

账号名。

avatar

string

Y

–

账号头像。

isAdmin

boolean

Y

–

是否是管理员账号。

fullName

string

Y

–

账号全名。

creationTime

long

Y

–

账号创建时间戳。

state

int

Y

–

账号状态。

0 - 状态正常
3 - 账号被禁用

online

boolean

Y

–

账号是否在线。

taskRunning

boolean

Y

–

账号当前是否有正在执行的任务。

lastAddress

string

N

–

账号最近一次连接服务器的地址。

lastLoginTime

long

N

–

账号最近一次登录时间戳。

lastDevice

JSON Object

N

–

账号最近一次登录的设备信息。参看 设备 。

token

string

N

–

账号的授权令牌。

设备

字段

类型

必填

默认值

描述

width

int

Y

–

设备屏幕分辨率宽度。例如 1080。

height

int

Y

–

设备屏幕分辨率高度。例如 1920。

buildId

string

Y

–

修订版本号。

broad

string

Y

–

设备板卡型号。

brand

string

Y

–

与产品或硬件相关的厂商品牌，例如 “Xiaomi”, “Huawei”。

device

string

Y

–

设备在工业设计中的名称。

model

string

Y

–

设备型号。

product

string

Y

–

整个产品的名称。

bootloader

string

Y

–

设备 Bootloader 的版本。

hardware

string

Y

–

设备的硬件名称。

fingerprint

string

Y

–

构建(build)的唯一标识码。

sdkInt

int

Y

–

Android 系统 API 版本。

incremental

string

Y

–

底层源代码版本控制描述，用于表示此构建的内部值。

release

string

Y

–

Android 系统版本号。

baseOS

string

Y

–

产品所基于的基础操作系统。

securityPatch

string

Y

–

用户可见的安全补丁级别。

codename

string

Y

–

开发代号。

buildDisplay

string

Y

–

用于显示给用户的构建ID字符串。