用标准 HTTP 请求控制设备

01　获取设备地址与 API Token

在设备管理界面的安全设置中创建 API Token。将下方的 YOUR_DEVICE 和 YOUR_API_TOKEN 替换为实际管理地址与 Token，协议使用设备已配置的 HTTP 或 HTTPS。

脚本通过 Authorization: Bearer 进行认证。请求体使用 application/json。

export CHAOSBRIDGE_URL="https://YOUR_DEVICE"
export CHAOSBRIDGE_TOKEN="YOUR_API_TOKEN"

curl --fail-with-body \
  -H "Authorization: Bearer $CHAOSBRIDGE_TOKEN" \
  "$CHAOSBRIDGE_URL/api/v1/engines"

检查 HTTP 状态码和响应中的 success 字段。引擎查询响应提供引擎、端口与能力信息；使用响应中的实际标识继续操作。

02　为已有链路设置单向 100 ms 时延

此示例对应多功能系列。先从目标引擎的虚拟链路列表中确认链路 ID，再替换 YOUR_LINK_ID。请求只更新 A → B 方向的固定时延，其他未提交字段保持原配置。

export LINK_ID="YOUR_LINK_ID"

curl --fail-with-body -X PATCH \
  "$CHAOSBRIDGE_URL/api/v1/virtual-links/$LINK_ID" \
  -H "Authorization: Bearer $CHAOSBRIDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "direction_a_to_b": {
        "enabled": true,
        "delay": {"mode": 1, "value_ms": 100}
      }
    }
  }'

PATCH 成功表示配置请求已完成。还需确认匹配规则指向该链路、仿真已启用，并通过被测端流量与统计验证效果。FPGA 系列使用对应的硬件配置字段，可由技术顾问提供示例。

03　下载 Python 连接示例

只使用 Python 3 自带的 urllib、json 等标准库。脚本查询引擎和指定引擎的虚拟链路，包含超时、HTTP 错误与响应检查。

python3 chaosbridge_api_example.py --url "$CHAOSBRIDGE_URL"

# 使用上一步响应中的实际引擎 ID，读取该引擎的虚拟链路
python3 chaosbridge_api_example.py \
  --url "$CHAOSBRIDGE_URL" --engine-id YOUR_ENGINE_ID

将输出重定向到 JSON 文件，即可保存本次设备发现结果，作为自动化测试流程的起点。

从一次请求到自动化回归

连接设备 → 读取目标链路 → 配置网络条件 → 执行业务测试 → 采集统计与抓包 → 保存结果。可以使用 Python、Java、JavaScript、C#、Go 或其他支持 HTTP 的语言组织这一流程。

需要批量配置、循环测试、错误重试或 CSV 报告时，可以把测试步骤告诉网准通技术顾问。