后台接口文档

Quick Start

三步接入

所有接口均以 HTTPS + JSON 调用，语言与框架无关。先取 Token，再按业务分组调用。

# 1) 换取 Token（请求体字段见文档站「01 接入鉴权」）
curl -X POST 'https://service.nihaoxiaozhi.com/openapi/auth/token' \
  -H 'Content-Type: application/json' \
  -d '{"account":"YOUR_ACCOUNT","password":"YOUR_PASSWORD"}'

# 2) 带 Token 调用业务接口
curl -X POST 'https://service.nihaoxiaozhi.com/openapi/user/info' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json'

示例中的 account / password 为占位字段，请以文档站「01 接入鉴权」为准。

Auth

鉴权方式

采用 Bearer Token：先通过 POST /openapi/auth/token 换取，之后每个业务请求都要带上。

• Token 不可本地解析，不要依赖客户端判断过期时间；收到鉴权失败时重新换取。
• Token 属于账号凭证，请放在服务端保存和调用，不要下发到浏览器或小程序前端。

Convention

环境与响应约定

文档站当前的 servers 指向测试环境，联调前先确认目标环境。

• Token 有效期 30 天，不是 JWT，无法在本地解析过期时间，过期后重新换取即可。
• 文档中同时存在 code 与 errorCode 两套业务码包装，按具体接口的实际返回读取。
• 大量业务错误仍以 HTTP 200 返回，需同时判断 HTTP 状态码与响应体业务码。
• 示例中的 YOUR_TOKEN、DEMO_OPENID 等均为演示数据，不能直接用于调用。

Groups

接口分组

完整文档按下列 10 个分组组织，每个分组内含接口说明、参数表与调用示例。

Reference

完整接口参考

下方为开放平台完整文档，支持搜索与在线调试；也可以在新窗口中单独打开。