使用API登录
如何通过API登录到FCC
有多个API端点可用于登录。这里描述的登录API是/login。还有不同的,比如/auth/forceLogin,如果用户已经登录了,它可以通过结束一个旧的会话来强制登录。
要使用Swagger API,请确保在xserver.properties中设置xserver.swagger.enable=true
。
要创建一个请求,创建一个POST调用到/login,像https://my-address/login。该调用的JSON主体应该是这样的。
{
"username":"myuser",
"password":"qwer1234",
"domain":"ubimax",
"agreedToTos":"true"
}
在这里我们指定用户名、密码和域名。这样做之后,我们就可以执行请求了。
我们得到的答复将是这样的。
{
"token": "eyJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJGQ0MiLCJzdWIiOiJ0ZXN0ZXIiLCJkb21haW4iOiJ1YmltYXgiLCJpZCI6MTYyOTI4NDQ0ODg0OSwiaWF0IjoxNjI5Mjg0NDQ4LCJleHAiOjE2MjkyODQ3NDh9.9qhH0Jpf-xtzPa5Gu3CUt89dVag-8obzV-dNYsGojs_GNdfSfcM_iJ4rA01-Wg7Gr3LQfRkjtLhC95AHLmtc5A",
"refreshToken": "eyJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJGQ0MiLCJzdWIiOiJ0ZXN0ZXIiLCJkb21haW4iOiJ1YmltYXgiLCJpYXQiOjE2MjkyODQ0NDgsImV4cCI6MTYyOTg4OTI0OH0.-L38U0FsXHhOJCxWus4kXEezSm6tcZ3u2nKzhZX9C_0ZqyRrscG7sDNWsP8gUREeNRrXpvA1YAUqamQRQb8_QA",
"permissions": [
"ROLE_adm_administration",
...
]
}
对于下面的API调用,我们现在可以使用我们收到的作为承载令牌的令牌作为授权。
要了解可用的API调用的总体情况,请访问https://my-address/admin.html#!/apis。
这里列出了所有的API调用及其执行所需的数据,也可以进行试用。这将是/login的API描述。
在这里,我们看到一个usernamePasswordLoginModel被期待,它被定义在下面作为一个例子。如果我们现在填写这个字段并执行请求。结果看起来是这样的。
结果显示了我们发送请求的URL和curl命令。