应用维护信息获取接口
基本信息
接口描述: 查询应用的实时维护信息,可在 开发者运营管理平台-应用管理-接口设置-维护 中配置维护事件。
接口地址: https://api.chinadlrs.com/developer/maint.php
请求方式: POST
响应格式: JSON
请求参数
请求头 (Headers)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Content-Type | string | 是 | 必须设置为 application/json |
请求体 (Body)
| 参数名 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|
| appid | int | 是 | 应用唯一标识符 | 1 |
| apptoken | string | 是 | 加密后的应用秘钥 | "ABCDE..." |
数据加密
apptoken 参数是经过加密的字符串,用于验证应用权限和保护数据安全
具体的加密算法请参考《数据加密说明文档》
请求示例
{
"appid": 1,
"apptoken": "ABCDE..."
}
响应参数
响应参数表
| 参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
| code | number | 状态码 | 200 |
| data | object | 维护数据对象 | |
| data.content | string | 维护内容(可能 | "U2FsdGVkX1+...加密后的信息" |
| data.end_time | string | 维护结束时间(可能不存在) | "U2FsdGVkX1+...加密后的信息" |
| data.allow_login | boolean | 是否允许登录 | false |
| msg | string | 成功消息 | "操作成功" |
成功响应示例(有维护信息)
{
"code": 200,
"data": {
"content": "U2FsdGVkX1+...加密后的信息", // 例行维护
"end_time": "U2FsdGVkX1+...加密后的信息", // 2026-04-01 12:00:00
"allow_login": false
},
"msg": "操作成功"
}
成功响应示例(无维护事件或不在维护时间内)
{
"code": 201,
"data": null,
"msg": "操作成功"
}
错误响应示例
{
"code": 400,
"data": null,
"msg": "参数缺失或无效"
}
{
"code": 401,
"data": null,
"msg": "秘钥验证失败"
}
状态码说明
| 状态码 | 描述 | 解决方案 |
|---|---|---|
| 200 | 查询成功,有维护事件,返回维护信息 | |
| 201 | 查询成功,无维护事件或不在维护时间内 | |
| 400 | 参数缺失或无效 | 检查 appid 和 apptoken 参数是否提供 |
| 401 | 秘钥验证失败 | 检查 apptoken 是否正确 |