jf-open-pro-device-list - 杰峰设备列表查询技能（开发版）

技能描述

支持查询开发者账号下绑定的设备信息列表：

• 分页查询 - 获取账号下所有绑定的设备
• 条件查询 - 按设备序列号列表查询（最多 100 个）
• 设备信息 - 返回设备序列号、用户名、昵称、Token 等

触发词

• 查询设备列表 / 设备列表 / 我的设备
• 绑定设备 / 设备分页 / 查询绑定设备

前置条件

必需配置

1. 签名算法 - 使用杰峰官方移位加密算法生成 signature
2. 时间戳算法 - counter(7 位) + timeMillis(13 位)，实时生成
3. 开放平台账号 - 需要有绑定的设备

环境变量

API 接口

核心功能

设备列表查询（Device List）

API: POST /gwp/v3/rtc/device/list

请求参数：

响应参数：

查询场景

场景 1：分页查询

获取开发者账号下的所有绑定设备信息列表。

请求示例：

{
  "page": 1,
  "limit": 100
}

场景 2：条件查询（按设备序列号列表）

指定设备序列号查询设备信息列表（最多 100 个）。

请求示例：

{
  "sns": ["5e26d516f54f500dxxxx", "115477b8705dxxxx"]
}

使用示例

环境准备

# 设置环境变量（使用占位符，请替换为实际值）
export JF_UUID="uuidxxxx"
export JF_APP_KEY="appkeyxxxx"
export JF_APP_SECRET="appsecretxxxx"
export JF_MOVE_CARD="2"
export JF_ENDPOINT="api-cn.jftechws.com"

1. 查询设备列表（分页）

cd ~/.openclaw/workspace/skills/developer/jf-open-pro-device-list/scripts

# 查询第 1 页，每页 100 个
python3 device_list.py --action list

# 查询第 2 页
python3 device_list.py --action list --page 2

# 每页 50 个
python3 device_list.py --action list --limit 50

2. 按设备序列号查询

# 查询指定设备
python3 device_list.py --action query-by-sns \
  --sns "devicesnxxxx"

# 查询多个设备（最多 100 个）
python3 device_list.py --action query-by-sns \
  --sns "devicesnxxxx,devicesnyyyy"

3. 从文件读取设备序列号

# 从文件读取设备序列号列表
python3 device_list.py --action query-by-sns \
  --sns-file "devices.txt"

4. 格式化输出

# 表格格式输出（推荐）
python3 device_list.py --action list --format table

# JSON 格式输出
python3 device_list.py --action list --format json

设备序列号文件格式

# devices.txt - 设备序列号列表文件
# 格式：每行一个设备序列号
devicesnxxxx
devicesnyyyy
devicesnzzzz

状态码

平台状态码

注意事项

1. 分页限制 - 每页最大 100 个设备
2. 条件查询 - 最多查询 100 个设备序列号
3. 设备信息 - 部分设备可能没有 nickname 或 loginToken
4. 密码安全 - 设备密码可能为空或加密显示

相关文件

参考文档

• 杰峰开放平台