资源工坊

用户授权流程 ​

流程说明 ​

1、开发者在开发者后台-安全设置配置回调地址。 2、用户访问应用时，应用按要求构造授权跳转链接。用户授权成功后，页面将重定向到授权回调地址 redirect_uri，并附带 code 和 state 参数。如：redirect_uri?code={string}&state={string}。 3、通过 code 获取用户 access_token。 4、通过用户 access_token 获取用户信息。

调用时序

构造授权跳转链接 ​

根据定义，构造授权跳转链接，用户同意授权后，会重定向跳转到指定的 redirect_uri，并附带 code、state 两个参数。

请注意：第三方企业应用接入WPS应用市场时，需使用应用市场专用授权接口：ISV应用授权接口

请求说明 ​

请求地址https://openapi.wps.cn/oauth2/auth
请求方法GET
签名方式无
支持应用类型企业自建应用、第三方企业应用、第三方个人应用
权限要求无

查询参数（query） ​

参数参数类型是否必填说明
client_idstring是应用 APPID
response_typestring是参数值必须为 code
redirect_uristring是使用开者后台应用配置的【用户授权回调地址】经过encode后的值
scopestring是用户授权的权限，使用英文逗号分隔，如：scope1,scope2,scope3
statestring否应用自定义数据，授权成功后重定向时会带出

请求地址示例 ​

http
[GET] https://openapi.wps.cn/oauth2/auth?response_type=code&client_id={string}&redirect_uri={string}&scope={scope1,scope2,scope3}&state={string}

请求响应 ​

  • 若用户未登录，则会先跳转到登录页进行登录：

用户登录

  • 若用户已登录未授权，则会先跳转到授权页：

用户授权

  • 若用户已授权，则重定向到 redirect_uri，并携带临时授权码 code 和用户自定义参数 state。示例：redirect_uri?code={string}&state={string}。

📌 注意：code 作为换取 access_token 的票据，仅可使用一次且 10 分钟未被使用自动过期。

根据 code 获取用户 access_token ​

应用获取到 code 之后，服务端调用该接口获取用于访问用户授权凭证 access_token。详见获取用户 access_token。

需要注意的是：由于应用 APPKEY 和获取到的 access_token 安全级别比较高，后续刷新 access_token、通过 access_token 获取用户信息等步骤，必须从服务器调用接口。

刷新用户 access_token ​

access_token 的有效期为 2 小时，开发者可以使用 refresh_token 调用刷新用户 access_token重新获取一个有效的 access_token。需注意 2 点：

  • 若原 access_token 未过期，原 access_token 仍可使用，直到原有效期截止失效
  • 重新获取的 access_token 的值与原 access_token 不一致，请注意区分使用

refresh_token 有效期为 365 天，当 refresh_token 失效之后，需要用户重新授权。 使用 refresh_token 刷新 access_token 时，会返回一个新的 refresh_token，原 refresh_token 自动失效。