葡萄城报表提供验证用户登录信息的REST API,可供业务系统调用,以获得一个令牌(Token)。该令牌可用于调取报表内容等后续操作。 登录验证API的URL为如下形式:
http://<报表服务器IP>:<端口>/api/accounts/login
下面的javascript代码,是一个登录报表服务器的函数示例:
function</span> loginArs(serverUrl, userName, userPassword) { var params = { user: userName, password: userPassword, }; var token; $.ajax({ type: "POST", url: serverUrl + '/api/accounts/login', data: JSON.stringify(params), contentType: "application/json", dataType: "json", async: false, // 同步调用,等待返回 success: function (data) { token = data['Token']; } }); return token; }
该函数的返回值就是报表系统的令牌(Token),内容是一个经过Base64编码的字符串。
通过调用API实现的单点登录集成,一般的应用场景是从业务系统直接调用某个报表,即在业务系统的页面上直接显示某一个报表的内容。完整的示例请参见后面的用户界面集成部分。