api:oauth2_token

获取员工access_token

请求地址

https://openapi.b.qq.com/oauth2/token

请求方式

get

请求样例

https://openapi.b.qq.com/oauth2/token?grant_type=authorization_code&app_id=APPID&app_secret=APPSECERT&code=CODE&state=&redirect_uri=http://www.test.com/usercallback

注意:

1.openid为永久id

2.access_token过期为90天(建议在90天内进行更新access_token操作)

请求参数

字段名称 字段类型 字段说明
grant_type string 授权类型”authorization_code”
app_id int 第三方应用的app_id
app_secret string 与app_id对应的app_secret
code string 如果用户登录并授权成功,则会跳转到指定的回调地址,
并在URL中通过GET参数传回该值,其值的获取方法,
详见获取员工授权
state string 帮助第三方防范CSRF攻击的,会原样返回
redirect_uri string 必须与获取员工授权接口中传的redirect_uri值相一致

返回结果

{
  "ret": 0,
  "msg": "调用成功",
  "data": {
    "access_token": "40ba32b83bce8276e1f3bfc1bee329b6",
    "expires_in": "7776000",
    "refresh_token": "38c5a1cb7ae17be163320047ea034cb1",
    "open_id": "0f09375d4e73599bcfa665d195fa7697",
    "company_token": "",
    "company_id": "000a3d937971d3675423bccfc53798a1",
    "state": ""
  }
}

返回JSON格式的数据:

字段名称 字段类型 字段说明
ret int 返回码:0 正常, >0 异常
msg string 如果ret不为0,会有相应的错误信息提示,UTF-8编码。
data object JS对象格式的数据

data格式:

字段名称 字段类型 字段说明
access_token string 认证token
expires_inint 是该access token的有效期,单位为秒
statestring 与请求参数中的state一样
open_idstring 当前登录的号码,或者当前授权的号码的open_id
refresh_tokenstring access_token过期后,调用 刷新access token

返回

api/oauth2_token.txt · 最后更改: 2016/04/22 17:09 (外部编辑)