鉴权接口
场景描述
此接口为CTI-OBS通过用户名和密码访问CC-iSales鉴权接口。
接口方法
Post
接口URI
https://域名/rest/isales/v1/openapi/obs/auth/login,例如域名是service.besclouds.com。
请求说明
|
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
|
1 |
Content-Type |
String |
False |
"application/json" |
|
序号 |
参数 |
是否必选 |
类型 |
描述 |
|
1 |
user |
True |
String |
用户名 |
|
2 |
passwd |
True |
String |
密码 |
响应说明
- 响应状态码: 200
表3 响应体参数 序号
名称
参数类型
说明
1
result
String
错误码。取值如下:
0:成功
非0:失败
2
resultData
Object
查询成功后,返回结果信息的对象。
表4 resultData对象 序号
参数
类型
描述
1
token
String
鉴权token字段
2
tokenExpirationTime
String
鉴权字段token有效时间
3
refreshToken
String
刷新token
4
refreshExpirationTime
String
刷新token有效时间
错误码
- 响应状态码: 400
错误的请求:请检查请求路径及参数。
- 响应状态码: 401
未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
- 响应状态码: 403
鉴权失败。
- 响应状态码: 404
请求的内容未找到:请检查请求的路径。
- 响应状态码: 500
业务失败:请依次确认您请求中各参数的取值。
报文样例
- 请求头:
Content-Type:application/json
- 请求消息:
{
"user":"abcd",
"passwd":"123456"
}
- 响应消息:
{ "result":0, // 0:成功,其他失败 "resultData": { "token":"fajiofjqwioeha", "tokenExpirationTime":300,// 单位秒 "refreshToken":"fajiofjqwioeha", "refreshExpirationTime":3600,// 单位秒 } }