Mirai HTTP API 使用教程

Mirai HTTP API 使用教程

【免费下载链接】mirai-api-http 项目地址: https://gitcode.com/gh_mirrors/mir/mirai-api-http

1. 项目介绍

Mirai HTTP API 是一个为 Mirai 机器人框架提供的 HTTP API 插件。它允许开发者通过 HTTP 请求与 Mirai 机器人进行交互，从而实现各种自动化任务和功能扩展。Mirai 是一个基于 Kotlin 的开源 QQ 机器人框架，而 Mirai HTTP API 插件则进一步扩展了其功能，使其能够通过 HTTP 接口进行远程控制和数据交互。

2. 项目快速启动

2.1 安装 Mirai HTTP API

首先，确保你已经安装了 Mirai Console Loader (MCL)，然后使用以下命令安装 Mirai HTTP API 插件：

/mcl --update-package net.mamoe:mirai-api-http --channel stable-v2 --type plugin

2.2 配置 Mirai HTTP API

编辑配置文件 config/net.mamoe.mirai-api-http/setting.yml，如果没有则自行创建：

adapters:
  - http
  - ws
enableVerify: true
verifyKey: 1234567890
debug: false
singleMode: false

2.3 启动 Mirai Console

使用以下命令启动 Mirai Console：

/mcl

2.4 使用 HTTP API

启动后，你可以通过 HTTP 请求与 Mirai 机器人进行交互。例如，发送一条消息：

curl -X POST "http://localhost:8080/sendFriendMessage" -H "Content-Type: application/json" -d '{"sessionKey": "your_session_key", "target": 123456789, "messageChain": ["Hello, Mirai!"]}'

3. 应用案例和最佳实践

3.1 自动化消息发送

通过 Mirai HTTP API，你可以编写脚本来自动发送消息。例如，每天定时发送天气预报：

import requests
import json

url = "http://localhost:8080/sendFriendMessage"
headers = {"Content-Type": "application/json"}
data = {
    "sessionKey": "your_session_key",
    "target": 123456789,
    "messageChain": ["今天的天气是晴天，温度25℃。"]
}

response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.text)

3.2 事件监听与处理

你可以通过 HTTP API 监听 Mirai 的事件，并进行相应的处理。例如，处理好友申请：

import requests

url = "http://localhost:8080/resp/newFriendRequestEvent"
headers = {"Content-Type": "application/json"}
data = {
    "sessionKey": "your_session_key",
    "eventId": 123456789,
    "fromId": 987654321,
    "groupId": 123456789,
    "operate": 0,
    "message": "欢迎加入！"
}

response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.text)

4. 典型生态项目

4.1 Mirai Console

Mirai Console 是 Mirai 的核心组件，提供了命令行界面和插件系统，是开发 Mirai 机器人的基础。

4.2 Mirai Core

Mirai Core 是 Mirai 的核心库，提供了与 QQ 客户端通信的基础功能，是 Mirai 机器人框架的核心。

4.3 Mirai Login Solver Selenium

Mirai Login Solver Selenium 是一个用于解决 QQ 登录验证码的插件，通过 Selenium 自动化浏览器来处理验证码。

通过这些生态项目，你可以构建一个功能强大的 QQ 机器人系统，实现各种自动化任务和功能扩展。

【免费下载链接】mirai-api-http 项目地址: https://gitcode.com/gh_mirrors/mir/mirai-api-http