1. 服务说明

博客的API接口提供开发测试调用，往后提供的API也会往开发调试这方面靠，博客API会保证 稳定性。

博客的API接口不建议用于生产环境，因为博客程序会偶尔更新版本，虽然原则上已发布的API会 少改动，但万一我写出BUG呢（逃）。

出于对安全性考虑，对于部分敏感的API调用（如消耗资源类型）会限制单位时间内的请求次数。

API接口不定期更新，原则上会保证任何已经发布的API的信息不做删除，如需修改也会提前一定时间公布。

注：博客程序部署的域名已部署超过3年，请放心使用。

2. 服务分享

2.1. syncthing 中继服务

服务: relay://www.chancel.me:2206/?id=ZY73TOU-DLR4KHS-TMQTTTP-QG22MQX-XY4PBUO-GX3OLFD-DGQT6RY-HRV37A5

syncthing是一款非常好用的p2p同步软件，但国内复杂的NAT网络偶尔导致同步文件很慢，借助上面的中继服务器可以实现稳定的文件同步

使用方法

1. 打开syncthing控制台，选settings-connections
2. 在sync protcol listen address 中填入relay://[domain:port]/?id=[id]

如图

2.2. Gravatar头像加速服务

地址：https://gravatar.chancel.me/avatar

使用方法

1. 打开程序博客配置，将Gravatar官方链接替换为上述链接

2.3. PlantUML插件服务(Joplin)

地址：https://plantuml.chancel.me

使用方法

1. 打开Joplin菜单栏-Tools-Options-Plugins并安装PlantUMl插件
2. 安装完成后，在Joplin菜单栏-Tools-Options-Plugins子类中选择PlantUML插件，选择私有服务器，并填入上述服务地址，如图

搭建文档参考： plantuml/plantuml-server - github.com

3. API列表

3.1. 随机图片获取

地址：https://api.chancel.me/rest/api/v1/image

请求方法：GET

接口说明：用于获取随机webp图片，尺寸是1920x1080，支持自定义宽度或者高度，图片来源网络不做内容保证

请求参数

返回参数

二进制图片内容

3.2. IP查询

地址：https://api.chancel.me/rest/api/v1/ip

请求方法：GET

接口说明：返回调用者的IP

请求参数

返回参数

CURL - 示例

curl https://api.chancel.me/rest/api/v1/ip

返回示例

{
    "data":{
        "ip":"173.242.127.92"
    },
    "message":"查询成功",
    "status":1
}

3.3. Telegram代理请求

地址：https://api.chancel.me/rest/api/v1/telegram

请求方法：POST

接口说明：由于众所周知的问题，导致Telegram的API无法正常调用，所以提供此API用于调用Telegram的消息机器人通知

请求参数

返回参数

CURL - 示例

curl -X POST -H "Content-Type:application/json" -d '{"apiKey":"2126564823:AdksmwskKm_BKGf8kKsjdxaGveuUHHKVx-Y","msgText":"hello","chatId":"793833844"}' https://api.chancel.me/rest/api/v1/telegram

返回示例

{
    "status": 1,
    "msg": "消息发送成功",
    "data": {
        "chat": {
            "first_name": "chancel",
            "id": 793833844,
            "last_name": "shuai",
            "type": "private",
            "username": "chancel"
        },
        "date": 1638782848,
        "from": {
            "first_name": "MideaMsgBot",
            "id": 2062029367,
            "is_bot": true,
            "username": "MideaMsgBot"
        },
        "message_id": 12,
        "text": "hello"
    }
}

[[replyMessage== null?"发表评论":"发表评论 @ " + replyMessage.m_author]]

评论列表([[messageResponse.total]])

[[messageItem.m_author]] [[messageItem.m_author]]

[[messageItem.create_time]]

[[getEnviron(messageItem.m_environ)]] forum

[[subMessage.m_author]] [[subMessage.m_author]] @ [[subMessage.parent_message.m_author]] [[subMessage.parent_message.m_author]]

[[subMessage.create_time]]

[[getEnviron(messageItem.m_environ)]] forum