软件接口
软件接口提供全局配置、版本检测、公告等功能,通常在软件启动时调用。
GET /api/v1/software/config — 获取软件配置
获取软件的全局配置数据(Query 参数)。
请求参数(Query)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
app_key | string | 是 | 软件 App Key |
nonce | string | 是 | 随机字符串 |
timestamp | number | 是 | Unix 时间戳(秒) |
sign | string | 是 | 请求签名 |
返回数据(result)
| 字段名 | 类型 | 说明 |
|---|---|---|
config | string | 软件全局配置内容 |
GET /api/v1/software/latest_ver — 检查更新
检查是否有新版本,若已是最新版返回错误码 10304。
请求参数(Query)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
app_key | string | 是 | 软件 App Key |
version | string | 是 | 当前客户端版本号 |
nonce | string | 是 | 随机字符串 |
timestamp | number | 是 | Unix 时间戳(秒) |
sign | string | 是 | 请求签名 |
返回数据(result)
| 字段名 | 类型 | 说明 |
|---|---|---|
version | string | 最新版本号 |
notice | string | 更新说明 |
url | string | 下载地址 |
server_time | number | 服务器时间戳 |
GET /api/v1/software/notice — 获取公告
获取软件公告内容(Query 参数)。
请求参数(Query)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
app_key | string | 是 | 软件 App Key |
nonce | string | 是 | 随机字符串 |
timestamp | number | 是 | Unix 时间戳(秒) |
sign | string | 是 | 请求签名 |
返回数据(result)
| 字段名 | 类型 | 说明 |
|---|---|---|
notice | string | 公告内容 |