服务地址与请求头
所有 REST API 请求共享相同的服务地址和请求头规范,本页说明 {baseUrl} 的构成方式和必填请求头。
服务地址
{baseUrl} 表示服务域名,不包含 /wlte/v1。 仅支持 HTTPS 访问。
text
https://openapi.svnwi.com完整请求地址由 {baseUrl} 加接口路径组成。 环境地址会在开通 API 环境时提供。
通用请求规则
- 带请求体的接口使用
Content-Type: application/json - 所有接口推荐使用
Accept: application/json - 需要认证的接口应包含
Authorization: Bearer {accessToken} - JSON 字段使用 camelCase
- 时间字段使用 RFC3339 UTC 字符串,例如
2026-04-29T10:28:45.258Z - 请求和响应体均使用 UTF-8 编码
集成要求
该 API 仅供后端服务集成使用,不支持直接从浏览器、移动端 App 或其他客户端侧环境调用。
客户应在自有后端服务中统一管理凭证和调用逻辑,再由自己的服务向上层应用提供能力。
安全规则
clientSecret只应保存在客户自有后端服务、服务器任务或其他受控服务端运行环境中- 不要将
clientSecret写入浏览器代码、移动端 App 或公开代码仓库 - access token 应按敏感信息处理,不应写入公开日志
- 凭证轮换方式和环境域名会在开通 API 环境时提供
请求追踪 ID
- OpenAPI 服务会在响应包体中返回
requestId - 调用方系统应记录
requestId,用于排障、日志关联和工单追踪 - 联系技术支持时,请提供对应请求的
requestId、请求时间和接口路径
