8.2.2 登录验证API

葡萄城报表提供验证用户登录信息的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实现的单点登录集成，一般的应用场景是从业务系统直接调用某个报表，即在业务系统的页面上直接显示某一个报表的内容。完整的示例请参见后面的用户界面集成部分。

Page tree

8.2.2 登录验证API