申请access_token

简述：

传入授权AppKey，申请access_token

请求URL：

http://ip:port/iform/oauth2/v3/authentication/apply
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

POST

请求参数：

Headers：
暂无
Query：
暂无
Body：

名称	类型	是否必须	备注
grant_type	String	是	请求类型，可选值为：authorization_code/password_credentials/client_credentials/refresh_token
authorize_code	String	否	调用authorize获得的code值，grant_type为authorization_code时必填
client_id	String	否	申请应用时分配的AppKey
client_secret	String	否	申请应用时分配的AppSecret
refresh_token	String	否	调用access_token获得的refresh_token值，grant_type为refresh_token时必填
username	String	否	用户名
password	String	否	密码,grant_type为password_credentials时必填
redirect_uri	String	否	回调地址

请求参数示例：

示例1：

{
    "client_id": "iform",
    "client_secret": "58b65297-3467-0859-8337-8cbaf81ef68a",
    "authorize_code": "6173f3c0f9fa11e906ee9dff8b7b5da8",
    "grant_type": "authorization_code"
}

示例2：

{
    "client_id": "iform",
    "client_secret": "58b65297-3467-0859-8337-8cbaf81ef68a",
    "grant_type": "client_credentials"
}

示例3：

{
    "client_id": "iform",
    "client_secret": "58b65297-3467-0859-8337-8cbaf81ef68a",
    "username": "iform",
    "password": "123456",
    "grant_type": "password_credentials"
}

示例4：根据刷新token值请求新token

{
    "refresh_token": "58b65297-3467-0859-8337-8cbaf81ef68a",
    "grant_type": "refresh_token"
}

返回示例：

结果1：

{
    "state": 200,
    "request": null,
    "message": "",
    "cause": "",
    "variables": {
        "code": "086670360d004dd78b681d602e50741d",# code凭证
        "redirect_uri": null
    },
    "data": {
        "access_token": "61797200f9fa11e906ee9dff8b7b5da8",
        "refresh_token": "61797201f9fa11e906ee9dff8b7b5da8",
        "primary_refresh_token": null,
        "uid": "626353848415420416",
        "publisher": null,
        "applicant": null,
        "expires_in": 28800,
        "remind_in": 259200
    }
}

返回参数说明：

名称	类型	备注
access_token	String	系统令牌值，简称token
refresh_token	String	用于刷新请求新token的刷新令牌
primary_refresh_	token	String
uid	String	用户ID
publisher	String
applicant	String
expires_in	Integer	token的生命周期，单位秒
remind_in	Integer	refresh_token的生命周期，单位秒
code	String	第三方获取用户信息的凭证
redirect_uri	String	回调地址

获取令牌列表

简述：

获取令牌列表

请求URL：

http://ip:port/iform/oauth2/v3/authentication/query
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

POST

请求参数：

Headers：

名称	类型	是否必须	默认值备注	其他信息
X-Authorization-access_token	String	是		系统令牌

Query：

暂无

Body：

名称	类型	是否必须	默认值	备注	其他信息
request	APIRequest[1]	是		动态查询请求对象

请求参数示例：

{
  "requestPage": {
    "pageNo": 1,
    "limit": 15
   }
}

请求参数示例：

{
  "state": 200,
  "request": null,
  "message": "",
  "cause": "",
  "variables": {},
  "data": {
    "dataResult": [
      {
        "accessToken": "7d9a03d0fa1a11e9c9869cf7db4dca77",
        "refreshToken": "7d9a03d1fa1a11e9c9869cf7db4dca77",
        "identity": "ccc",
        "identityType": "user",
        "accessTokenTtlSeconds": 26348,
        "refreshTokenTtlSeconds": 256748,
        "accessTokenTtlDate": "2019-10-29 23:05:29",
        "refreshTokenTtlDate": "2019-11-01 15:05:29"
      },
      {
        "accessToken": "e3bef280f9f011e906ee9dff8b7b5da8",
        "refreshToken": "e3bef281f9f011e906ee9dff8b7b5da8",
        "identity": "tom",
        "identityType": "user",
        "accessTokenTtlSeconds": 8481,
        "refreshTokenTtlSeconds": 238881,
        "accessTokenTtlDate": "2019-10-29 18:07:42",
        "refreshTokenTtlDate": "2019-11-01 10:07:42"
      }
    ],
    "pageResult": {
      "limit": 15,
      "page": 1,
      "totalCount": 2,
      "totalPages": 1
    }
  }
}

返回参数说明：

名称	类型	备注
dataResult	Array	****令牌列表数据
pageResult	Object	分页数据

令牌删除

简述：

令牌删除

请求URL：

http://ip:port/iform/oauth2/v3/authentication/remove
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

POST

请求参数：

Headers：

名称	类型	是否必须	默认值	备注
X-Authorization-access_token	String	是		系统令牌

Query：
暂无
Body：

名称	类型	是否必须	默认值	备注	其他信息
type	String	是		令牌类型，可选值token/refresh
tokens	List	是		令牌集合

请求参数示例：

待完善

返回示例：

待完善

返回参数说明：

名称	类型	备注
data	Object	待完善

切换用户

简述：

切换用户

请求URL：

http://ip:port/iform/oauth2/v3/authentication/switch
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

POST

请求参数：

Headers：

名称	类型	是否必须	默认值	备注	其他信息
X-Authorization-access_token	String	是		系统令牌

Query：
暂无
Body：

名称	类型	是否必须	备注
grant_type	String	是	请求类型，可选值authorization_code/password_credentials/client_credentials/refresh_token
client_id	String	是	申请应用时分配的AppKey
client_secret	String	是	申请应用时分配的AppSecret
access_token	String	是	执行切换的管理员访问令牌
username	String	是	切换目标用户名
redirect_uri	String	否	回调地址

请求参数示例：

{
    "client_id": "iform",
    "client_secret": "58b65297-3467-0859-8337-8cbaf81ef68a",
    "grant_type": "authorization_code",
    "access_token": "0d732c20fa2011e9c9869cf7db4dca77",
    "username": "admin"
}

返回示例：

{
    "state": 200,
    "request": null,
    "message": "",
    "cause": "",
    "variables": {},
    "data": {
        "access_token": "caf536c0fa2611e9c9869cf7db4dca77",
        "refresh_token": "caf55dd0fa2611e9c9869cf7db4dca77",
        "primary_refresh_token": "0d732c21fa2011e9c9869cf7db4dca77",
        "uid": null,
        "publisher": null,
        "applicant": null,
        "expires_in": 28800,
        "remind_in": 259200
    }
}

返回参数说明：

名称	类型	备注
access_token	String	系统令牌值，简称token
refresh_token	String	用于刷新请求新token的刷新令牌
primary_refresh_token	String
uid	String	用户ID
publisher	String
applicant	String
expires_in	Integer	token的生命周期，单位秒
remind_in	Integer	refresh_token的生命周期，单位秒

退出切换用户

简述：

退出切换用户

请求URL：

http://ip:port/iform/oauth2/v3/authentication/switch/exit
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

POST

请求参数：

Headers：

名称	类型	是否必须	默认值	备注	其他信息
X-Authorization-access_token	String	是		系统令牌

Query：

暂无

Body：

名称	类型	是否必须	备注
grant_type	String	是	请求类型，可选值authorization_code/password_credentials/client_credentials/refresh_token
client_id	String	是	申请应用时分配的AppKey
client_secret	String	是	申请应用时分配的AppSecret
access_token	String	是	执行切换的管理员访问令牌
username	String	是	切换目标用户名
redirect_uri	String	否	回调地址

请求参数示例：

{
    "client_id": "iform",
    "client_secret": "58b65297-3467-0859-8337-8cbaf81ef68a",
    "grant_type": "authorization_code",
    "access_token": "caf536c0fa2611e9c9869cf7db4dca77",
    "username": "admin"
}

返回示例：

{
    "state": 200,
    "request": null,
    "message": "",
    "cause": "",
    "variables": {},
    "data": {
        "access_token": "84f395b0fa2911e9c9869cf7db4dca77",
        "refresh_token": "84f395b1fa2911e9c9869cf7db4dca77",
        "primary_refresh_token": null,
        "uid": "626353848415420416",
        "publisher": null,
        "applicant": null,
        "expires_in": 28800,
        "remind_in": 259200
    }
}

返回参数说明：

名称	类型	备注
access_token	String	系统令牌值，简称token
refresh_token	String	用于刷新请求新token的刷新令牌
primary_refresh_token	String
uid	String	用户ID
publisher	String
applicant	String
expires_in	Integer	token的生命周期，单位秒
remind_in	Integer	refresh_token的生命周期，单位秒

校验令牌

简述：

校验令牌

请求URL：

http://ip:port/iform/oauth2/v3/authentication/verify
URL中的ip需要替换为自己网关ip
URL中的port需要替换为自己网关端口

请求方式：

POST

请求参数：

Headers：
暂无
Query：

名称	类型	是否必须	默认值	备注	其他信息
access_token	String	是		访问令牌

Body：

暂无

请求参数示例：

http://ip:port/iform/oauth2/v3/authentication/verify?access_token=84f395b0fa2911e9c9869cf7db4dca77

返回示例：

{
  "state": 200,
  "request": null,
  "message": "",
  "cause": "",
  "variables": {
    "clientId": "iform",
    "grant.type": "authorization_code"
  },
  "data": "zjh"
}

返回参数说明：

名称	类型	备注
data	String	用户名
variables.clientId	String	申请应用时分配的AppKey
variables.grant.type	String	请求类型

作者：caoyl 创建时间：2024-02-28 15:46
最后编辑：caoyl 更新时间：2025-10-24 18:04

认证接口文档

申请access_token

获取令牌列表

令牌删除

切换用户

退出切换用户

校验令牌