● 后端接口服务站点

接口文档

本站同时作为后端接口服务站点,为上述系统及授权应用提供标准化、安全可控的数据接口。以下为接口说明(示例,可按真实后端实现调整)。

BASE

基础信息

Base URL
# 生产环境 https://您的域名/api/v1
协议与编码
全站采用 HTTPS 加密传输;请求与响应均为 application/json,字符编码 UTF-8。
鉴权方式:Bearer Token。除 /api/v1/health 外,其余接口均需在请求头携带 Authorization: Bearer <token>。
ENDPOINTS

接口列表

GET/api/v1/health
服务健康检查,无需鉴权。返回当前服务状态与时间戳。
# 响应 200 { "status": "ok", "time": "2026-01-01T00:00:00Z", "version": "1.0.0" }
POST/api/v1/auth/token
获取接口访问令牌。需在请求体提供凭证(示例字段,以真实实现为准)。
参数类型说明
app_idstring应用标识
app_secretstring应用密钥
# 响应 200 { "access_token": "eyJhbGciOi...", "token_type": "Bearer", "expires_in": 3600 }
GET/api/v1/resources
查询受保护业务资源列表,需 Bearer Token。支持分页参数 page、size。
# 请求示例 GET /api/v1/resources?page=1&size=20 Authorization: Bearer <token> # 响应 200 { "items": [ { "id": 1, "name": "示例资源" } ], "total": 1, "page": 1, "size": 20 }
POST/api/v1/systems/{id}/sync
触发指定管理信息系统的数据同步任务,需 Bearer Token 与相应权限。
# 请求示例 POST /api/v1/systems/1001/sync Authorization: Bearer <token> # 响应 202(已接受) { "task_id": "sync-abc123", "status": "accepted" }
COMPLIANCE

合规与备案

承诺 前置审批内容合规承诺

本单位承诺:在未取得对应前置审批文件前,网站 / APP 不会涉及到信息网络传播视听节目(直播、音视频播放、广播电视节目传播)前置审批相关内容。