用户登录
方式一:(在Manager平台上创建的开发者账号只能用方式一传参)
接口功能
该接口用于用户获取accessToken。
注意:
获取到的accessToken有效期是大约2小时,调用接口若出现401错误则通过refreshToken调用重新登录接口刷新accessToken,若通过refreshToken获取不到再通过用户名和密码获取,不要访问频繁,若超过一定频率,会屏蔽IP处理。
注意:
该文档中所有接口均不支持跨域请求请求地址:(二选一)
新版:
URL:
[Host Server]/idserver/core/connect/token
旧版:
URL:
[Id Server]/core/connect/token
地址参数说明
参数名 类型 参数描述 Id Server string 详情见名词解释 Method
POST
Headers
NULL
Body
参数名 类型 描述 scope string fbox client_id string 开发者ID client_secret string 密钥原文 grant_type string client_credentials
注意 :
登录接口与重新登录接口的Content-Type(body的格式)为application/x-www-form-urlencoded
其他接口body的格式为均为application/json格式。
client_id
、client_secret
为在Manager平台创建的开发者ID、密钥,详情见开发者创建页面。
scope
和grant_type
为描述中所述固定值。
返回字段
字段名 类型 参数描述 access_token string accessToken expires_in int accessToken的有效期 token_type string accessToken的类型(Bearer)固定值 返回码
返回码 描述 400 "error_description"="invalid_username_or_password"(账号或密码错误)
或"error": "invalid_client"(开发者账号或密码错误)404 接口不存在,请检查URL 429 被服务器拒绝(登录过于频繁,客户端被禁止等),详情见429状态码 调用案例如下图
方式二:(向我司销售申请的开发者账号只能用方式二方式传参)
接口功能
该接口用于用户获取accessToken。
注意:
获取到的accessToken有效期是2小时,refreshToken有效期为30天,调用接口若出现401错误则通过refreshToken调用重新登录接口刷新accessToken,若通过refreshToken获取不到再通过用户名和密码获取,不要访问频繁,若超过一定频率,会屏蔽IP处理。
注意:
该文档中所有接口均不支持跨域请求请求地址:(二选一)
新版:
URL:
[Host Server]/idserver/core/connect/token
旧版:
URL:
[Id Server]/core/connect/token
参数说明
参数名 类型 参数描述 Id Server string 详情见名词解释 Method
POST
Headers
NULL
Body
参数名 类型 描述 username string FBox 客户端账号 password string FBox 客户端密码 scope string openid offline_access fbox email profile client_id string 开发者账号 client_secret string 开发者密码 grant_type string password 注意 :
登录接口与重新登录接口的Content-Type(body的格式)为application/x-www-form-urlencoded
其他接口body的格式为均为application/json格式。username
、password
为登录FlexManager账号密码。请自行下载FlexManager并注册client_id
、client_secret
为服务器为各种客户端所创建的开发者账号、密码,用于区分各类客户端,请联系与贵公司对接的销售获取。scope
和grant_type
为描述中所述固定值。返回字段
字段名 类型 参数描述 access_token string accessToken expires_in int accessToken的有效期 refresh_token string accessToken过期后,刷新accessToken token_type string accessToken的类型(Bearer)固定值 返回码
返回码 描述 400 "error_description"="invalid_username_or_password"(账号或密码错误)
或"error": "invalid_client"(开发者账号或密码错误)404 接口不存在,请检查URL 429 被服务器拒绝(登录过于频繁,客户端被禁止等) 调用案例如下图