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

发送消息给联系人