1. 描述

查询房人。

2. 调用场景

开发者登录http://consolex.xdua.com后,可以以God角色查询属于所有房人。

3. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name QryRosr
URL https://api.xdua.com/rosr
Method GET
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod QRY
XduaApiColor X 只有持有神房人，才可以创建房人
XduaApiAudience ConsoleX 只有rosr_id为ConsoleX的房人，也就是consolex.xdua.com才可以发起本请求
XduaApiShop XdUaXduA 房人直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u 所有注册房人均可以使用
XduaApiRoles Butler 必须是Zoon才可以查询角色
XduaApiResource rosr
XduaApiKparam where 常量where
XduaApiAction QueryRosr
XduaApiRule QueryRosr
XduaApiAstates 0 所有状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

4. URL

GET:https://api.xdua.com/rosr

5. 请求参数

参考标准查询接口请求参数

支持的查询参数

名称 位置 类型 示例 说明
room_id where string rYub4wrT 详情的房人ID
rold_id where string rYub4wrT 根据角色ID查询房人
rold_code where string rYub4wrT 根据角色code查询房人
name where string 房人的名称精确查询
name[~] where string 房人的名称模糊查询

6. 返回参数

参考标准查询接口返回参数

result.list部分,注意下面的位置表达,result.list[]表示这些字段在list里的每一项里都出现。

名称 位置 类型 示例 说明
id result.list[] string rYub4wrT 详情的房人ID
name result.list[] string 房人的名称
room_id result.list[] string 房间的ID
room_name result.list[] string 房间的名字
devp_id result.list[] string 产品的ID
devp_name result.list[] string 产品的名字
user_id result.list[] string 用户的ID
user_name result.list[] string 用户的名字
role_code result.list[] string 设备的数值
state result.list[] int 0 房人的状态
stato result.list[] string "冻服更新" 房人的状态说
expire result.list[] int 0 房人状态过期时间(UNIX时间戳)
creator_id result.list[] string Dmtv7TrE 房人创建者ID
creator_name result.list[] string 辣椒帅 房人创建者名字
updator_id result.list[] string XiyRvUp3 房人最近一次更新者ID
updator_name result.list[] string 周海潮 房人最近一次更新者名字
cstamp result.list[] string 2020-01-20 02:19:55 房人创建时间
ustamp result.list[] string 2020-01-20 02:23:24 房人最近更新时间

7. 错误码

错误码来自于error字段,通用错误码参考地球号通用错误码

8. SDK调用

const XduaClient = require('lovearth-xdua-browser-sdk')
const xduaClient = await XduaClient({
    LOGIN_TOKEN:"eyJhbGciOi...",//开发者在地球号开发者网站创建的登录令牌
})

/*----------------------------
 * 运行如下代码
 * 下面的代码是直接可以运行的
 *--------------------------*/
api_name = "查询房人";


/*---------------------------------------
 * 查询room_id=="9COkOKGl"下的所有人员
 * 下面的代码是直接可以运行的
 *-------------------------------------*/

let query_param = {
    limit:20,
    page:1,
    where:{room_id  :   "9COkOKGl"}    
}

/*---------------------------------------
 * 查询room_id=="9COkOKGl"下的所有护工
 * 下面的代码是直接可以运行的
 *-------------------------------------*/

let query_param = {
    limit:20,
    page:1,
    where:{room_id  :   "9COkOKGl",role_code:"Carer"}    
}


const res_api = await xduaClient.qryRosr(query_params)

if(res.error == 0){
    console.log("测试成功");    
}else{
    console.log("测试失败");   
}

文档还没有实现

```

{% sample lang="php" -%}

文档还没有实现

```bash

results matching ""

    No results matching ""