版本管理接口
基本信息
接口描述: 查询应用在指定版本序列下的各版本信息,可用于应用更新检测等功能。
接口地址: https://api.chinadlrs.com/developer/version.php
请求方式: POST
响应格式: JSON
请求参数
查询参数 (Query Parameters)
| 参数名 | 类型 | 必填 | 描述 | 默认值 |
|---|---|---|---|---|
| lang | string | 否 | 响应语言(zh/en) | zh |
查询参数
查询参数通过在接口地址后直接拼接的方式传递,地址和参数之间用 ? 分隔,多个参数之间用 & 连接。
例如响应语言为英文的接口地址为:
https://api.chinadlrs.com/developer/version.php?lang=en
请求头 (Headers)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Content-Type | string | 是 | 必须设置为 application/json |
请求体 (Body)
| 参数名 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|
| appid | int | 是 | 应用唯一标识符 | 1 |
| sequence | string | 是 | 经过加密的序列号字符串 | "GBq8V1" |
数据加密
sequence 参数是经过加密的字符串,用于验证应用权限和保护数据安全
具体的加密算法请参考《数据加密说明文档》
请求示例
{
"appid": 1,
"sequence": "GBq8V1"
}
响应参数
响应参数表
| 参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
| code | number | 状态码 | 200 |
| data | object | 版本数据对象 | |
| data.version | string[] | 版本号数组 | ["1.0.0", "1.0.1"] |
| msg | string | 成功消息 | "操作成功" |
成功响应示例
{
"code": 200,
"data": {
"version": ["1.0.0", "1.2.1"]
},
"msg": "操作成功"
}
错误响应示例
{
"code": 400,
"data": null,
"msg": "参数缺失"
}
状态码说明
| 状态码 | 描述 | 解决方案 |
|---|---|---|
| 200 | 操作成功 | |
| 400 | 请求参数缺失 | 检查 appid 和 sequence 参数是否提供 |
| 404 | 应用不存在 | 验证 appid 是否正确 |
| 404 | 版本信息未找到 | 检查版本序列号是否正确 |