# API 文档

微信机器人管理系统提供了一系列API接口，方便您进行系统集成或自动化操作。 所有API都需要认证，请在请求头中添加`Authorization`头部。

### 认证方式

在HTTP请求头中添加：

    Authorization: Bearer YOUR_API_TOKEN

API Token可在系统设置中生成和管理。

## 可用API端点

### 机器人管理

GET /api/v1/robots

获取所有机器人列表

    {
      "success": true,
      "data": [
        {
          "id": 1,
          "nickname": "客服机器人",
          "container_id": "abcdef123456",
          "status": "online",
          "wechat_id": "wxid_12345",
          "created_at": "2025-01-01T12:00:00Z",
          "last_login_at": "2025-01-02T12:00:00Z"
        },
        {
          "id": 2,
          "nickname": "营销机器人",
          "container_id": "ghijkl789012",
          "status": "offline",
          "wechat_id": null,
          "created_at": "2025-01-01T14:00:00Z",
          "last_login_at": null
        }
      ]
    }

GET /api/v1/robots/:id

获取指定机器人的详细信息

    {
      "success": true,
      "data": {
        "id": 1,
        "nickname": "客服机器人",
        "container_id": "abcdef123456",
        "container_host": "localhost:9001",
        "status": "online",
        "wechat_id": "wxid_12345",
        "avatar": "base64-encoded-avatar",
        "created_at": "2025-01-01T12:00:00Z",
        "last_login_at": "2025-01-02T12:00:00Z"
      }
    }

POST /api/v1/robots

创建新机器人

请求体:

    {
      "name": "新机器人",
      "port": 9002  // 可选，容器端口映射
    }

响应:

    {
      "success": true,
      "data": {
        "id": 3,
        "nickname": "新机器人",
        "container_id": "mnopqr345678",
        "container_host": "localhost:9002",
        "status": "offline",
        "created_at": "2025-01-03T10:00:00Z"
      }
    }

### 联系人管理

GET /api/v1/robots/:id/contacts

获取机器人的联系人列表

GET /api/v1/contacts/:id/messages

获取与联系人的聊天记录

### 消息管理

POST /api/v1/contacts/:id/messages

发送消息给联系人