API

token

URI

http://supermapimanager:8390/imanager/security/tokens[.<format>]

支持的方法

POST

介绍

根据用户信息获取 Token。

支持的方法：

• POST：根据用户信息获取 Token。

支持的表述格式：JSON。

HTTP 请求方法

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

http://supermapimanager:8390/imanager/security/tokens.json

POST 请求

根据用户信息获取 Token。

请求参数

获取 Token 时应在请求体中传递如下参数：

响应结构

如果输入的用户名，密码正确，则直接返回一个字符串，即具有该用户权限的 Token。

如果输入的用户名，密码未通过验证，则返回响应码为 401。

响应示例

对 tokens 资源执行 POST 请求：http://supermapimanager:8390/imanager/security/tokens.json，在请求体中传入参数，如下所示

请求头:

Host: supermapimanager:8390
Content-Type: application/json; charset=UTF-8
Referer: http://supermapimanager:8390/imanager/

请求体:

{
  "username": "admin",
  "password": "admin"
}

则返回的内容如下：

7ac687f1-51c3-46ad-8617-89d737d1ba0d

有了Token，用户在创建 GIS 环境时，就可以不登录，直接携带 Token 访问这些需要权限访问的资源，以下以创建 GIS 服务器为例。

在未登录的状态下，对http://supermapimanager:8390/imanager/web/nodes/server.json执行POST请求，请求头中传入token

Host: supermapimanager:8390
Content-Type: application/json; charset=UTF-8
X-Auth-Token: 7ac687f1-51c3-46ad-8617-89d737d1ba0d
Referer: http://supermapimanager:8390/imanager/

请求体传入相关参数，如下所示：

{
  "nodeSpec": "MEDIUM",
  "nodeCount": 1,
  "nodeName": "iserver",
  "password": "",
  "description": "",
  "physicalMachineName": "admin"
}

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

{
  "isSucceed": true,
  "msg": "",
  "resultId": "684"
}

如需退出登录，对http://supermapimanager:8390/imanager/security/logout执行GET请求。