1. 通过日志服务查看API调用日志

参考阿里云API日志服务

API网关和日志服务实现无缝集成，通过日志服务您可以进行实时日志查询、下载、多维度统计分析等，您也可以将日志投递到OSS或者MaxCompute。

我们在阿里云网关配置日志，而且日志定位在dua日志服务里的dua_aglog。日志的字段如下。

这样的日志格式是阿里云面向开发者的，它自然是一些通用字段。无法满足地球号具体业务逻辑的调试。所以我们会把地球号具体业务逻辑的调试放置在另一个日志仓库（dua_fclog）里。

运维要做的是，在dua_fclog查询api。如果查不到，就到dua_aglog查询api。

客户端延迟

aglog只给出了服务器端的延迟，并没有给出客户端到服务器端延迟。这一点不好。如果我们想分析全求各地对接口的延迟分析。就需要把全球各地的客户端感受到的延迟都统计起来。这点只有SDK能够做到了。延迟分析,只需要分析到IP就行。

注意：我们在服务器端用mysql统计日志是不合理的，应该删掉。日志应该用maxcompute去加工。加工的结果再存入关系数据库。

2. 描述

创建服志。

3. 调用场景

开发者登录超级控制台后,可以以Butler角色创建自己的服志。服志创建目前只能由Butler进行。

创建服志需要用户先登录自己的账户，进入企业，店铺，然后创建。

4. 配置参数

参数意义参考接口参数

5. 请求参数

6. 返回参数

7. 错误码

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

8. SDK调用

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

/*-----------------------------------------------------------
 * 首先在控制台点击企业按钮，进入企业
 *---------------------------------------------------------*/

api_name = "登续到济南分所";
logon_param = {
    id  :   "IctJinan",
}

res = await xduaClient.addLogon(logon_param)
if(res.status == 200){
    if(res.error == 0){
        got_zone_id = res.result.id;
        console.log(api_name+"成功 ");
    }else{
        got_zone_id = res.result.id;
        console.log(res);
    }
}else{
    console.log(res);
}
/*-----------------------------------------------------------
 * 首先在控制台点击店铺按钮，进入店铺
 *---------------------------------------------------------*/
api_name = "登续到商务中心养老院";
logon_param = {
    id  :   "Facility",
}

res = await xduaClient.addLogon(logon_param)
if(res.status == 200){
    if(res.error == 0){
        got_zone_id = res.result.id;
        console.log(api_name+"成功 ");
    }else{
        got_zone_id = res.result.id;
        console.log(res);
    }
}else{
    console.log(res);
}




/*-----------------------------------------------------------
 * 在店铺界面创建服志
 *---------------------------------------------------------*/
const add_params = {
    build_id:"W0wPuXU3",                             //服志所在的楼栋,`商务中心A座`
    type_id:"m5d00001",                             //服志种类ID,表示`养老院护理间`
    name:"一楼107",                                 //服志的名字
    addr:"商务中心养老公寓主楼107",     //服志地址,这个会做全平台唯一性检查
}



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

```

{% sample lang="php" -%}

文档还没有实现

```bash

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

/*----------------------------
 * 运行如下代码
 * 下面的删除操作是不会成功的，
 * 因为"TeStTeSt"作为一个测试服志是不可以被删除的。如果为了测试，可以新建一个服志，然后立刻删除。
 *--------------------------*/
const apilog_id ="TeStTeSt"; //要删除的服志ID
let res = await xduaClient.delRoom(apilog_id)
if(res.error == 0){
    console.log("测试成功");    
}else{
    console.log("测试失败");   
    console.log(res); 
}

```

{% sample lang="php" -%}

文档还没有实现

```bash

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

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


/*------------------------------------------------------
 * 分页查询店铺(shop_id)下的所有服志,
 * 比方说，某个养老院的所有服志
 *----------------------------------------------------*/

let query_param = {
    limit:20,
    page:2,
    where:{shop_id:"Facility"}    
}

/*------------------------------------------------------
 * 查询服志名字的模糊查询
 *----------------------------------------------------*/

let query_param = {
    limit:20,
    page:2,
    where:{"name[~]":"%济南市%"}    
}

/*------------------------------------------------------
 * 分页查询小区`Vila0001`下的服志
 * 
 *----------------------------------------------------*/
let query_param = {
    limit:20,
    page:1,
    where:{
        vila_id:"Vila0001",
    }    
}


const res_api = await xduaClient.qryApilog(query_params)

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

```

{% sample lang="php" -%}

文档还没有实现

```bash

9. 描述

回收服志。

10. 调用场景

管理员应开发者的要求，登录超级控制台后,查询到某个开发者下面的被删除的服志。然后回收。开发者刷新就可以看到了。为此，开发者要提供自己的uid和要回收的服志的名字。

11. 配置参数

参数意义参考接口参数

12. 请求参数

13. 返回参数

14. 错误码

15. 描述

修改服志信息。本接口是God可以访问的，God几乎可以修改Room的所有属性。在未来，Room的不重要属性可以被其它角色修改。

16. 调用场景

开发者登录超级控制台后,可以修改自己创建的服志。开发者以God角色修改服志。未来可能开放给专门的服志/设备运维。

17. 配置参数

参数意义参考接口参数

18. 请求参数

19. 返回参数

示例

result字段

{
    "id":"rYub4wrT",
    "updates":{
        "name":"新的服志名",
        "brief":"新的服志介绍",    
    }    
}

20. 错误码

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

21. SDK调用

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

/*----------------------------

• 运行如下代码
• 下面的代码是直接可以运行的 --------------------------/ api_name = "修改服志"; const apilog_id ="TeStTeSt"; //要修改的服志ID

/*----------------------------

• 下面展示的是修改"TeStTeSt"所有属性的操作，实际上可以只修改其中任何一个到两个参数 --------------------------/ const set_params = { type:"Room", //服志新的类型 name:"测试服志", //名字 addr:"服志新的地址", //服志生产商 }

const res_api = await xduaClient.setRoom(apilog_id,set_params)

if(res.error == 0){ console.log("测试成功");
}else{ console.log("测试失败");
console.log(res); } </code></pre> </div>

```

{% sample lang="php" -%}

文档还没有实现

</code></pre>
</div></div></div>
# 描述

修改服志。

# 调用场景

开发者登录[超级控制台](http://consolex.xdua.com)后,可以修改自己创建的服志。修改仅仅限于可以修改的name,brief等字段。


# 配置参数

参数意义参考[接口参数](http://docapi.xdua.com/api/param.html)

|参数名                 |参数值                   |说明     |
|------                 |------                   |----     |
|Name                   |SetRoomtmpl                  |         |
|URL                    |https://api.xdua.com/apilogtmpl|         |
|Method                 |PUT                     |         |
|XduaApiHttpSchema      |HTTPS                    | 只走HTTPS|
|XduaApiMethod          |SET                      |         |
|XduaApiColor      |X                        | 只有持有神服志，才可以创建服志        |
|XduaApiAudience   |ConsoleX                 | 只有apilog_id为ConsoleX的服志，也就是consolex.xdua.com才可以发起本请求|
|XduaApiShop       |XdUaXduA                 | 服志直辖店铺,只有这个店铺的登录人员才可以访问|
|XduaApiSubject    |i                        | i,只有创建者自己才可以修改|
|XduaApiRoles           |Zoon                     | 只要登录就可以创建服志|
|XduaApiResource        |apilog                     |     |
|XduaApiKparam          |id                       |     |
|XduaApiAction          |UpdateRoomtmpl               |     |
|XduaApiRule            |UpdateRoomtmpl               |     |
|XduaApiAstates         |0              | 按序apilog,zone,corp,shop,apilog,apilog,login的状态都必须是0(STATE_ENABLED)    |
|XduaApiEnable          |true                     | 接口使能    |


# 请求参数

|名称       | 位置|类型     |必填    |默认值  |示例    |说明                |
|-------    |-----|---------|--------|--------|--------|------------        |
|id         |path |string   |是      |        |rYub4wrT|要修改的服志ID      |
|name       |body |string   |否      |        |        |服志的名称，必须唯一，支持汉字、英文字母、数字、英文格式的下划线，必须以英文字母或汉字开头，4~32个字符 |
|avatar     |body |string   |否      |        |        |服志图标，不超过40个字符。|
|brief      |body |string   |否      |        |        |服志描述，不超过64个字符。|

|名称       | 位置|类型     |必填    |默认值    |示例                       |说明                       |
|-------    |-----|---------|--------|--------  |--------                   |------------               |
|user_id|path|String|用户m5d,登陆时获得|可选|
|oldpwd |body|String|旧服志,32位md5码|可选|
|pwd    |body|String|新服志,32位md5码|可选|



# 返回参数

|名称       | 位置  |类型       |示例        |说明                         |
|-------    |-----  |-----------|------------|------------                 |
|id         |result |string     |rYub4wrT    |修改的服志ID                 |
|ipdates    |result |json dict  |            |修改的内容                   |


#### 示例

result字段

```json
{
    "id":"rYub4wrT",
    "updates":{
        "name":"新的服志名",
        "brief":"新的服志介绍",    
    }    
}

22. 错误码