# Routing API

**HTTP API：** 消息路由

## 文档维护规范

0. **先改文档，再动代码** - 新功能或重大修改需先完成文档更新、并完成审阅后，再进行代码实现
1. **文档分层，链接代码** - 关键实现需标注代码文件路径；格式：`module/file.py:function_name`
2. **简洁快照，日志分离** - 只记录已确认的 API 设计

---

## 概述

消息路由 API 供外部 Agent 调用，用于：

- 查询联系人列表
- 发送消息到其他 Agent
- 管理路由规则

**实现位置：** `gateway/api/routing_api.py`

**基础路径：** `/api/routing`

---

## API 端点

### 查询联系人列表

**端点：** `GET /api/routing/contacts`

**用途：** 查询当前 Agent 的可见联系人列表

**说明：** 具体请求/响应格式待设计

### 发送消息

**端点：** `POST /api/routing/messages`

**用途：** 发送消息到其他 Agent

**说明：** 具体请求/响应格式待设计

### 查询路由规则

**端点：** `GET /api/routing/rules`

**用途：** 查询消息路由规则

**说明：** 具体请求/响应格式待设计

---

## 相关文档

- [Routing 核心模块](../core/routing.md)：核心实现
- [需求规划](../requirements.md)：消息路由需求
- [架构设计](../architecture.md)：API 层在整体架构中的位置
