更新时间：2025-11-13 GMT+08:00
认证接口
场景描述
用于接口认证。
接口方法
设置成“POST”。
URL
/chatbot/serverauth/login
请求参数
| 名称 | 是否必选 | 参数类型 | 长度 | 说明 |
|---|---|---|---|---|
| account | True | String | 32 | 登录账号 |
| nonce | True | String | 128 | 服务端提供的原始随机文本,来源于上一次业务请求返回401 unauthorized响应消息。 |
| checksum | True | String | 512 | 客户端根据nonce值及本地密钥使用HmacSHA256加密算法加密处理后的文本 |
响应参数
| 名称 | 是否必选 | 参数类型 | 长度 | 说明 |
|---|---|---|---|---|
| token | False | String | 128 | 认证成功必须返回,业务请求接口需要的token |
| duration | False | int | 4 | 认证成功必须返回,token有效期（秒） |
| error | False | String | 512 | 认证失败时返回错误信息,同时状态码返回401。 |
| nonce | False | String | 128 | 认证失败时返回,服务端随机生成的字符串。 |
报文样例
- 请求样例
{ "account":"odfs", "nonce":"*******", // 服务端提供的原始随机文本 "checksum":"0dbe11*******************0b505de" // 客户端根据nonce值及本地密钥使用HmacSHA256加密算法加密处理后的文本 } - 响应样例
{ "token":"2**************************d", "duration":3600 }
父主题： ODFS与第三方机器人系统对接的接口规格
