Skip to content

服务地址与请求头

所有 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、请求时间和接口路径
Docs buildVersion v1.2.19-20260602-174859-60
Copyright © 2026 WLTE