请求地址

http://ip:port/bi/api?action=getNode&token=xxxx

请求消息

请求参数

请求参数：xmlData（必填）

<?xml version="1.0" encoding="UTF-8"?>

<ref>

 <type>user</type>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

 <type>group</type>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

 <type>role</type>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

 <type>user</type>

 <path>g1/u1</path>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

 <type>group</type>

 <path>g1/g1-1</path>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

 <type>role</type>

 <path>admin_role</path>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

 <type>user</type>

 <name>u1</name>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

 <type>group</type>

 <name>g1</name>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

 <type>role</type>

 <name>admin_role</name>

</ref>

参数描述

节点参数信息

•type（必填）：节点类型，包括三种：用户、组和角色。

•path（选填）：节点完整路径

•name（选填）：节点名称

•name和path只能存在一个，当name和path同时存在时，以name为准。

•如果name和path都不存在或者为空，则返回该类型所有的对象。

示例

function getNode() {

 var xml = getXml();

 $.post("http://" + ip + ":" + port + "/" + project + "/api?action=getNode&token=xxxx",

    {xmlData : xml},

    function(result) {

    writeXml(result);

 });

}

响应消息

响应结果

•获取用户响应：

<?xml version="1.0" encoding="UTF-8"?>

<results>

  <result>

      <asset>

          <user>

              <name>u1</name>

              <alias></alias>

              <email>u1@qq.com</email>

              <parent>g1</parent>

              <roles>r1</roles>

              <priority>5</priority>

              <type>1</type>

              <createUser>admin</createUser>

              <createTime>2020-10-23 13:46:41</createTime>

              <updateUser>admin</updateUser>

              <updateTime>2020-10-23 14:31:19</updateTime>

              <areaCode></areaCode>

              <mobileNumber></mobileNumber>

              <extendAttrs><定制属性1>1

          </定制属性1>

          </extendAttrs>

      </user>

  </asset>

</result>

</results>

•获取组响应：

<?xml version="1.0" encoding="UTF-8"?>

<results>

  <result>

      <asset>

          <group>

              <name>g1</name>

              <parent>root</parent>

              <roles>r1</roles>

              <createUser>admin</createUser>

              <createTime>2020-10-23 14:30:58</createTime>

              <updateUser>admin</updateUser>

              <updateTime>2020-10-23 14:31:29</updateTime>

          </group>

      </asset>

  </result>

</results>

•获取角色响应:

<?xml version="1.0" encoding="UTF-8"?>

<results>

  <result>

      <asset>

          <role>

              <name>r1</name>

              <createUser>admin</createUser>

              <createTime>2020-10-23 14:31:06</createTime>

              <updateUser>admin</updateUser>

              <updateTime>2020-10-23 14:31:06</updateTime>

          </role>

      </asset>

  </result>

</results>

•操作失败

<?xml version="1.0" encoding="UTF-8"?>

<results>

 <result>

    <level>6</level>

    <message>角色“role1”不存在。</message>

 </result>

</results>

结果描述

响应结果信息为xml，直接parse即可。

•asset 为返回的节点信息。

•user，group，role：分别对应用户、组、角色信息。

•可以返回的用户信息有：

name：用户的名称；

alisa：用户的昵称；

email：用户的邮箱；

parent：用户的分组；

roles：用户的角色；

priority：用户的优先级；

type: 用户类型，1为编辑者，2为查看者，3为探索者；

createUser：创建此用户的人；

createTime：创建时间；

updateUser：最近更新此用户的人；

updateTime：最近更新时间；

areaCode：区号；

mobileNumber：手机号；

extendAttrs：用户的定制属性；

•可以返回的分组信息有：

name：分组的名称；

parent：分组的父级；

roles：分组的角色；

createUser：创建此分组的人；

createTime：创建时间；

updateUser：最近更新此分组的人；

updateTime：最近更新时间；

•可以返回的角色信息有：

name：角色的名称；

createUser：创建此角色的人；

createTime：创建时间；

updateUser：最近更新此角色的人；

updateTime：最近更新时间；

•level 返回类型，不同数值代表不同返回状态，见附录。

•message为接口操作结果信息。