INFO
公共 API 文档
面向轻量自动化和日常开发场景,提供多种常用接口服务。
接口约定
- 本站免费提供以下和更多的 API 接口服务,不得用于任何非法用途。
- 本站服务器性能和带宽有限,请勿发送频繁和过量的请求(<20 次/分钟)。
- 教程、留言、问题与打赏,请访问 https://www.xinac.net/9210.html。
- 钉钉机器人每分钟最多发送 20 条消息;超过 20 条后将限流 10 分钟(钉钉机器人官方接口限制)。
- 网站 Favicon 图标接口单 IP 最大并发数为 200。
GET
/words
每次请求随机选择一条语料。未传递 format 参数或传递其他值时,响应格式为 JSON。
Base URL
https://api.xinac.net请求地址
Request URLGET
/words?format=json
/words?format=text
查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
format可选 |
string | json 或 text;默认为 JSON。 |
JSON 响应
200 OKapplication/json
{
"text": "合理安排时间,就等于节约时间。—培根",
"ver": "2.0.0",
"author": "https://api.xinac.net"
}
Text 响应
200 OKtext/plain; charset=utf-8
合理安排时间,就等于节约时间。—培根
GET
网站 Favicon API
Favicon API 已完成全新升级,重构全部代码与处理逻辑:
- 大幅提升网站图标获取速度、成功率与准确度。
- 采用多节点、多线程处理请求,提升运行稳定性与接口响应速度。
- 支持几乎所有已知的 Web 图片格式。
Base URL
https://api.xinac.net/icon/请求地址
Request URLimage/*
https://api.xinac.net/icon/?url=https://www.baidu.com
查询参数
| 参数 | 要求 | 说明 |
|---|---|---|
url | 必需 | 网站 URL,仅支持 HTTP 或 HTTPS 地址。 |
响应说明
| 响应项 | 内容 | 说明 |
|---|---|---|
Content-Type | image/* | 按实际文件返回 ICO、PNG、JPEG、GIF、WebP、BMP、TIFF、JPEG 2000、SVG 或 AVIF。 |
X-Favicon-Cache | 缓存状态 | HIT、MISS 或 REFRESHED 表示已获得有效图标。 |
X-Favicon-Cache | 更新状态 | STALE 或 PROCESSING 表示旧图或默认图已返回,后台仍在更新。 |
X-Favicon-Cache | 回退状态 | NEGATIVE、FALLBACK、INVALID 或 BUSY 表示返回缓存图或默认图。 |
辅助接口
| 路径 | 响应 | 说明 |
|---|---|---|
/icon/ | HTML | 未提供 url 时打开在线查询与预览页面。 |
/icon/default | Image | 返回接口默认图标。 |
/favicon.png | Image | 返回接口默认图标。 |
GET / POST
群机器人消息通知 API
可向钉钉、企业微信和飞书群机器人发送文本消息,也可接收BT面板和1Panel面板及 NAS 的告警通知。支持 GET/POST 请求。
Base URL
https://api.xinac.net接口列表
| 路径 | 通道 | 说明 |
|---|---|---|
/dingtalk | 钉钉 | 发送钉钉群消息。 |
/wechat | 企业微信 | 发送企业微信群消息。 |
/feishu | 飞书 | 发送飞书群消息。 |
/message/{channel} | 通用消息 | {channel} 可选 dingtalk、wechat、feishu。 |
请求示例
Request URLGET / POST
/dingtalk?token=<ACCESS_TOKEN>&text=<TEXT>&keyword=<KEYWORD>&secret=<SECRET>
/wechat?token=<ACCESS_TOKEN>&text=<TEXT>
/feishu?token=<ACCESS_TOKEN>&text=<TEXT>&keyword=<KEYWORD>&secret=<SECRET>
/message/{channel}?token=<ACCESS_TOKEN>&text=<TEXT>
POST 请求体支持 application/json 和 application/x-www-form-urlencoded。
通用参数
| 参数 | 要求 | 说明 |
|---|---|---|
channel | 必需 | 通用入口的消息通道。 |
token | 必需 | 机器人 Token;GET 放入查询参数,POST 放入请求体。 |
text | 必需 | 消息内容;GET 放入查询参数,POST 放入请求体。 |
keyword | 可选 | 安全关键词;GET 放入查询参数,POST 放入请求体。 |
secret | 可选 | 签名密钥;GET 放入查询参数,POST 放入请求体。 |
JSON 响应
200 OKapplication/json
{
"errcode": 0,
"errmsg": "ok",
"version": "2.0.0",
"author": "https://api.xinac.net"
}
90031 表示缺少 token,90032 表示缺少消息内容,90033 表示请求体超过默认 1 MiB 限制。
在线调试
等待发送
GET
Bing 每日壁纸 API
获取最新、随机或近期 Bing 每日壁纸记录。图片服务独立运行,以下请求使用单独的服务地址。
Base URL
https://bing.xinac.net接口列表
| 路径 | 响应 | 说明 |
|---|---|---|
/api/today | JSON / Image | 返回最新一条壁纸记录,支持 format 参数。 |
/api/random | JSON / Image | 随机返回一条壁纸记录,支持 format 参数。 |
/api/7-days | JSON Array | 按日期从新到旧返回近期七天记录。 |
/api/15-days | JSON Array | 按日期从新到旧返回近期十五天记录。 |
请求地址
Request URLapplication/json
https://bing.xinac.net/api/today
https://bing.xinac.net/api/random
https://bing.xinac.net/api/7-days
https://bing.xinac.net/api/15-days
响应格式
| 参数 | 适用接口 | 说明 |
|---|---|---|
format=json |
/api/today/api/random |
返回包含壁纸日期、地址、标题和版权信息的 JSON 对象。 |
format=jpg |
/api/today/api/random |
返回 302 并跳转至原始图片地址。 |
请求示例
Request URLGET
https://bing.xinac.net/api/today?format=json
https://bing.xinac.net/api/today?format=jpg
JSON 响应示例
200 OKapplication/json
{
"format_date": "2026-08-19",
"url": "https://cn.bing.com/th?id=OHR.Example_1920x1080.jpg",
"title": "Bing 每日壁纸",
"copy_right": "图片版权信息"
}
JSON 字段
| 字段 | 类型 | 说明 |
|---|---|---|
format_date | string | 壁纸日期,格式为 YYYY-MM-DD。 |
url | string | Bing 原始图片地址。 |
title | string | 图片标题。 |
copy_right | string | 图片版权说明。 |