XDbot2 Cave API

[This-is-XiaoDeng]

请求地址

• https://caveapi.thisisxd.top
• https://caveapi.xdbot2.itcdt.top/

接口列表

随机回声洞

获取一个随机的回声洞内容，包括发送者和文本。

终结点	返回类型
/v1	application/json 或 text/javascript

参数

参数	必须	说明
return	否（默认 json）	返回类型（json/js）
caveIdVar	否	回声洞ID常量名（默认cave_id）
caveContentVar	否	回声洞内容常量名（默认cave_content）
caveSenderVar	否	回声洞投稿者常量名（默认cave_sender）

返回示例

请求：

https://caveapi.xdbot2.itcdt.top/v1

响应：

{"id":538,"sender":"IP:127.0.0.1","content":"风急天高猿啸哀，尚思为国戍轮台。夜兰卧听风吹雨，神里绫华入梦来\n\n—— 哔哩哔哩·UID506743561"}

请求：

https://caveapi.thisisxd.top/v1?return=js

响应：

const cave_id = "984"
const cave_content = "“皇上，奇变偶不变”\n“可以了可以了，我知道你要说啥了，去一下隔壁那旮沓，那里边一大堆穿越者，他们正在研究马克思主义，朕这边已经准备好改革开放了，你们赶紧研究研究怎么最快的切换到中国特色社会主义，赶紧”"
const cave_sender = "IP:127.0.0.1"

获取回声洞图片

获取一个指定ID的回声洞图片，以PNG格式返回。

终结点	返回类型
/v1/getImage	image/png

参数

参数	必填	说明
id	是	图片ID（回声洞内容中的 [[Img:<图片ID>]]）

返回示例

请求：

https://api.cave.xdbot2.itcdt.top/v1/getImage?id=1679146457.165848

响应：

获取 API 版本

获取当前API的版本号，以纯文本格式返回。

终结点	返回类型
/v1/version	text/plain

参数

无

返回示例

请求：

https://api.cave.xdbot2.itcdt.top/v1/version

响应：

v1.0.0-beta

许可

除特殊说明外，所有回声洞内容均采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。

[This-is-XiaoDeng]

部分功能（如JS返回等）正在开发中，服务使用 Cloudflare Worker + Vercel + GitHub 搭建

[This-is-XiaoDeng]

现在随即回声洞可以返回js啦！