# 客户现场调试指南 — 第三方接口联调

## 接口清单

| 接口 | 地址 |
|------|------|
| Token | `POST http://180.51.12.2/api/appsys/sso/httpheader/login/v1?username_=szls` |
| 告警推送 | `POST http://180.51.12.2/api/edge/edgecallmanages/vi-alarm/v1` |
| MinIO | `http://180.51.12.2:9000` |

---

## 第一步：确认三个接口可达

在能访问 `180.51.12.2` 的机器上执行。

### 1. Token 接口

```bash
curl -s -X POST \
  "http://180.51.12.2/api/appsys/sso/httpheader/login/v1?username_=szls"
```

预期返回 JSON，`responseBody.token` 有值。

### 2. 告警推送接口

把上一步拿到的 token 替换 `TOKEN_VALUE`：

```bash
curl -s -X POST \
  "http://180.51.12.2/api/edge/edgecallmanages/vi-alarm/v1" \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: TOKEN_VALUE" \
  -d '{"tenantCode":"32","channelNo":"test","alarmContent":"test","alarmTime":"2026-01-01 00:00:00","picInfo":[],"videoInfo":[]}'
```

预期返回 200。

### 3. MinIO 存储

```bash
curl -s "http://180.51.12.2:9000"
```

预期返回 MinIO XML 响应。

---

## 第二步：查看 Edge-Server 日志

在 Edge 设备上执行。

### 查看启动时加载的第三方地址

```bash
journalctl -u safesight-edge-server --no-pager \
  | grep -E "ExternalApiAction initialized|HttpAction initialized"
```

预期看到 `token_url=http://180.51.12.2/...` 和 `msg_url=http://180.51.12.2/...`。

如果 IP 不是 `180.51.12.2`，说明管理端下发的配置未更新。

### 实时跟踪告警和接口调用

```bash
journalctl -u safesight-edge-server -f \
  | grep -E "alarm.*trigger|ExternalApi|token|send ok|send failed"
```

---

## 第三步：触发告警，观察完整链路

找人走到摄像头前触发告警，观察日志。

正常流程：

```
[alarm] trigger event_id=xxx rule=unknown_face
[ExternalApiAction] token fetched successfully
[ExternalApiAction] send ok http=200 event_id=xxx
```

异常对照：

| 日志 | 对策 |
|------|------|
| 没有 `[alarm] trigger` | 检查阈值、摄像头、RTSP |
| 无 `token fetched successfully` | 回到第一步验证 token 接口 |
| `send failed http=401` | token 过期，检查 SSO 账号 |
| `send failed http=500` | 第三方内部错误，找客户排查 |
| 日志里完全没有 `ExternalApiAction` | 管理端集成服务未启用 external_api |
| `minio upload failed` | 检查 MinIO 凭据和 bucket |
| `curl_easy_perform` 错误 | Edge 到 180.51.12.2 网络不通 |

---

## 第四步：验证 Agent 本地告警

```bash
journalctl -u safesight-edge-agent --no-pager -n 200 \
  | grep -i "alarm\|report"
```

---

## 快速诊断

```bash
journalctl -u safesight-edge-server --no-pager -n 500 \
  | grep -E "ExternalApi|HttpAction|alarm.*trigger|token|send ok|send failed"
```

---

## 管理端配置检查

1. 登录管理端 → 资产管理 → 第三方服务
2. 确认告警服务和对象存储地址为 `180.51.12.2`
3. 如有修改，保存后重新下发设备配置