API调用说明
# API调用说明
# 调用声明
● 在使用智齿开放 API 时，需向智齿商务人员或售后人员申请 appid 和 app_key 并确认所属环境，后续调用 API 时需根据所属环境使用对应域名（阿里云：www.sobot.com ，腾讯云：www.soboten.com，语音类 API 除外）。
● 在调用接口时必须在 https 请求的 header 中携带 "token" 参数。
Token 是智齿客服接口开放平台全局唯一的接口调用凭据。 开发者在调用各业务接口时都需使用 Token，开发者需要进行妥善保存。 Token 的存储至少要保留 32 个字符空间。Token 的有效期目前为 24 个小时，需定时刷新，或根据接口返回的 Token 失效提示，进行重新获取。请求 Token 接口，无论 Token 是否存在，都会返回新的 Token，并重置 Token 的过期时间（目前 24 小时）。
Token 使用方式说明：
1、开发者需要统一获取和管理 Token，在调用智齿客服各个业务开放接口时都应该使用同一个的 Token，不应该每个业务都刷新获取新的 Token，否则容易导致 Token 失效，影响接口的正常调用；
2、目前 Token 的有效期通过返回的 expire_in 来传达，目前是 86,400 秒之内的值。开发者需要根据这个有效时间提前去刷新新 Token。
3、开发者需要根据接口返回的 Token 失效提示，进行重新获取 Token。
# 获取访问 Token
接口说明：
获取 API 开放接口 Token，此 Token 仅适用于智齿开放平台 5.0 版本全部 API 接口 。
请求方式：
GET
请求地址：
/api/get_token
请求参数：
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appid | String | 是 | 第三方用户接口调用唯一凭证id |
| create_time | String | 是 | 时间戳（秒），例如：2019-09-25 15:49:33 的时间戳1569397773 |
| sign | String | 是 | 签名，md5(appid+create_time+app_key) sign签名,app_key为密钥 |
请求示例：
curl https://${domain}/api/get_token?appid=1&create_time=1569397773&sign=258eec3118705112b2c53dc8043d4d34
返回参数：
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| ret_code | String | 是 | 返回编码 |
| ret_msg | String | 是 | 返回信息 |
| item | Object | 否 | 返回对象 |
item对象：
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| token | String | 是 | token编码 |
| expires_in | String | 是 | 凭证有效时间，单位：秒 |
时间戳转换参考工具：
http://tool.chinaz.com/Tools/unixtime.aspx
sign签名生成示例：
例如，appid = "1"; create_time="1569397773"; app_key="2"
sign = Md5("115693977732") 为 258eec3118705112b2c53dc8043d4d34。
返回示例：
{
"item": {
"token": "4ac37cb2e9c740dba4b75a34d5358802",
"expires_in": "86400"
},
"ret_code": "000000",
"ret_msg": "操作成功"
}
2
3
4
5
6
7
8
# 接口返回状态编码
# ● 操作成功
| 返回编码 | 编码说明 |
|---|---|
| 000000 | 操作成功（除此编码以外的编码为错误编码） |
# ● 系统异常
| 返回编码 | 编码说明 |
|---|---|
| 700046 | 当前企业所购的版本不支持使用接口（免费版、海外团队版不可使用） |
| 900001 | token为空 |
| 900002 | token已失效，请重新获取 |
| 900003 | signature错误 |
| 900004 | 没有找到公司的api配置信息 |
| 999999 | 系统未知异常 |