login

URI

<services_uri>/security/login[.<format>]

支持的方法

GET、POST、HEAD

父资源

services

介绍

服务器登录页面，服务管理器等受保护的页面需要登录并验证身份后才能访问。

支持的方法：

GET：获取登录的表单。
POST：提交用户名密码进行登录。
HEAD：检查 login 资源是否存在，或权限是否可以访问 login 资源。

支持的表述格式：rjson、json、html、xml。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/security/login.rjson

GET 请求

获取登录的表单。

POST 请求

提交用户名密码进行登录。

请求参数

发送请求时，需要在请求体中包含如下参数：

名称	类型	含义
username	String	【必选参数】用户名。
password	String	【必选参数】密码。
rememberme	boolean	记住我。如果为 true，系统会记住用户的登录状态，下次打开页面不需要重复登录。默认为 false。

响应结构

描述

字段	类型	说明
succeed	boolean	是否成功登录。
referer	String	登陆后跳转的页面。

响应示例

对 login 资源执行 POST 请求：http://localhost:8090/iserver/services/security/login.rjson，发送请求体如下：

{

"username": "user1",

"password": "user1",

"rememberme": "true"

}

则返回的 rjson 格式响应结果如下：

{

"succeed": true,

"referer": "/iserver/manager"

}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 login 资源是否存在，或者客户端是否有权限访问 login 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 login 资源是否支持<format>格式的表述。

URI