Skip to main content

如何认证

此认证只适用于此wintelapi接口

用户中心通用认证方式

概述

使用 中通天鸿用户中心 进行统一认证。推荐

从用户中心获取 access_token 后,在所有接口请求头加上 Authorization: Bearer {ACCESS_TOKEN} 即可

第一步

从您专属的中通天鸿 vip 售后人员处申请用户中心访问 client_id 与 client_secret。您将会得到一下信息:

  • client_id: 您的应用专属账号
  • client_secret: 您的应用密码
  • scope: 您的应用权限

第二步

从用户中心获取 access_token.

举例1:

POST https://account.icsoc.net/oauth2/token HTTP/1.1
Host: account.icsoc.net
Content-Type: application/x-www-form-urlencoded
cache-control: no-cache

client_id={CLIENT_ID}&client_secret={CLIENT_SECRET}&grant_type=password&username=6019072501|8005&password={password}&scope={SCOPE}

以上例子中 6019072501|8005 为 您的企业代码|坐席工号

举例2:

curl -X POST \
https://account.icsoc.net/oauth2/token \
-F client_id={CLIENT_ID} \
-F client_secret={CLIENT_SECRET} \
-F grant_type=password \
-F 'username={企业代码}|{工号}' \
-F password={password}
-F scope={SCOPE}

以上例子中,正常返回为:

{
"access_token": "434233e4631417de4da122f4275bf76854004f68",
"expires_in": 86400,
"token_type": "Bearer",
"scope": "openid",
"refresh_token": "007c70090faba9687a78072d8769ada2096bde12"
}
danger

请务必将 access_token 进行缓存

系统对每个坐席获取 access_token 的频率限制为 24小时周期内128次,超过此频率将获取 access_token 失败。

第三步

从第二步拿到的 access_token 即为您的访问凭证,在后续调用中,您只需要在请求头中加入

Authorization: Bearer 434233e4631417de4da122f4275bf76854004f68

即可