文档首页/ 云客服/ API参考/ 机器人管理/ ODFS与第三方机器人系统对接的接口规格/ 认证接口
更新时间：2023-09-27 GMT+08:00
查看PDF
分享

认证接口

场景描述

用于接口认证。

接口方法

设置成“POST”。

URL

/chatbot/serverauth/login

请求参数

表1 请求体参数

名称

是否必选

参数类型

长度

说明

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
}