基于OAuth2协议的OpenAPI鉴权

1、 云客服推送鉴权

1. 使用者可从云客服使用设置-对接中心-鉴权信息-oauth2.0中获取 client_id、client_secret(client_secret禁止保存在前端任何地方)。

2、 调用认证接口获取调用令牌及刷新令牌

调用认证接口/oauth/token获取OAuth2的调用令牌(AccessToken)和刷新令牌(RefreshToken)等信息。
请求地址:https://openapi.useasy.cn/oauth/token
请求方式:POST
请求头:Content-Type: application/x-www-form-urlencoded
请求参数:
参数参数名必填备注
grant_type授权类型Yauthorization_code:生成刷新令牌RefreshToken              refresh_token:使用刷新令牌生成调用令牌AccessToken
client_id客户端IDY
client_secret客户端密钥C条件必传,若grant_type为authorization_code时必传
refresh_token刷新令牌C条件必传,若grant_type为refresh_token时必传
scope授权范围N非必传,默认:ue-kf
state防 CSRF 随机串N随机字符串,长度不超过100,若请求有此参数,接口响应参数中就有此相同字段和数据。
接口响应:
参数参数名备注
access_token调用令牌
refresh_token刷新令牌
token_type令牌类型固定值:bearer
scope授权范围
expires_in当前返回的 access_token 有效期单位:秒
state原样返回客户端请求时传入的防 CSRF 随机串

3、 OpenAPI接口调用注意事项

获取AccessToken成功后,在业务相关OpenAPI接口调用时注意以下两点:  
1.1. 接口地址中的openapi更换为oauth,例如添加客户接口:https://openapi.useasy.cn/openapi/crm/add更换为https://openapi.useasy.cn/oauth/crm/add
1.2. 请求头中必须携带OAuth2协议参数:Authorization: Bearer {AccessToken}

4、 其他注意事项

1. 调用令牌(AccessToken):有效期为1个小时,每日最多可生成300次,推荐间隔10分钟生成一次。
2. 刷新令牌(RefreshToken):有效期为30天,每日最多可生成30次,推荐间隔10天生成一次。
2025-12-19