Lerwee API Skill - 乐维监控系统 API 集成

Name: Lerwee API Skill
Author: lerwee

当前版本: v6.0 | 最后更新: 2026-03-11 | 状态: 与官方文档完全同步

配置

设置 API 凭证和服务器信息：

# 服务器配置
export LERWEE_BASE_URL="http://192.168.1.79:8081/api/v6"
export LERWEE_SECRET=""

API 基础信息

Base URL: http://192.168.1.79:8081/api/v6
请求方法: POST
Content-Type: application/json
字符编码: UTF-8
时间格式: 北京时间 (UTC+8)
认证方式: 签名验证

签名算法

普通接口签名

所有接口需要在请求参数中包含：

timestamp (long, 必填): Unix 时间戳（秒，北京时间 UTC+8）
sign (string, 必填): 请求签名

签名计算步骤：

import hashlib

def make_sign(params, secret):
    """
    计算签名

    Args:
        params: 请求参数字典
        secret: 密钥

    Returns:
        签名字符串
    """
    # 1. 过滤空值、数组、sign 字段
    filtered = {k: v for k, v in params.items()
                if k != 'sign' and v != "" and v is not None and not isinstance(v, list)}

    # 2. 按键名字典序排序
    sorted_items = sorted(filtered.items())

    # 3. 拼接字符串（不包含键值分隔符）
    str_to_sign = ''.join([f"{k}{v}" for k, v in sorted_items])

    # 4. 计算签名
    sign = hashlib.sha1((secret + str_to_sign).encode('utf-8')).hexdigest().lower()

    return sign

特殊接口签名（事件平台等）

部分接口（如 /aialert/*）使用 JSON 序列化的 data 字段：

import json
import time

def make_data_params(data_dict, appid, token):
    """
    生成 data 参数和签名

    Args:
        data_dict: data 参数内容
        appid: 应用 ID
        token: 应用 token

    Returns:
        (data_json, timestamp, sign)
    """
    # 1. 添加 appid 和 token
    data_dict['appid'] = appid
    data_dict['token'] = token

    # 2. JSON 序列化
    data_json = json.dumps(data_dict, separators=(',', ':'))

    # 3. 生成时间戳
    timestamp = int(time.time())

    # 4. 计算签名
    sign_str = token + data_json + str(timestamp)
    sign = hashlib.sha1(sign_str.encode('utf-8')).hexdigest().lower()

    return data_json, timestamp, sign

API 模块索引

1. 监控中心 (Monitor)

监控对象管理（列表、创建、更新、删除）
监控对象详情、指标、宏
监控类型和配置

📄 详细参数: references/api_details_monitor.md

2. 设备探测 (Device Detection)

Agent 列表、创建、安装、卸载
Agent 状态检查
批量操作

📄 详细参数: references/api_details_device.md

3. 告警管理 (Alert)

告警列表、问题列表
告警统计、确认
告警历史查询

📄 详细参数: references/api_details_alert.md

4. 事件平台 (Event Platform)

事件列表、详情、关闭
事件数据接收
告警处理状态更新
第三方告警恢复

📄 详细参数: references/api_details_alert.md

5. 事件平台告警 (AI Alert)

告警列表、状态更新
告警关闭
第三方推送告警恢复（特殊签名）

📄 详细参数: references/api_details_alert.md

6. 业务视图 (Business View)

组织树、业务树
业务列表、告警、主机
业务统计

📄 详细参数: references/api_details_business.md

7. 链路监控 (Link Monitor)

链路列表、详情
链路添加、更新、删除

📄 详细参数: references/api_details_business.md

8. 网络拓扑 (Network Topology)

拓扑图列表、详情
拓扑图添加、更新、删除
节点和连线管理

📄 详细参数: references/api_details_business.md