Tool House 公开接口一览
站内几个工具依赖服务端提供数据（跨域、编码、证书等原因）。本文列出这些公开接口的路径、参数与返回结构，方便你自行调用或做二次开发。
本站多数工具是纯前端实现，数据不出浏览器。少数几个需要服务端参与，原因通常是跨域限制、上游编码问题或证书信任问题。这些接口都在 /api/public/ 下，无需认证。
IP 归属地查询
GET /api/public/ip/lookup?ip=8.8.8.8
返回该 IP 的归属地信息。不传 ip 参数时，服务端会取请求方的来源地址。
服务端代理了上游查询源，并对结果做了 10 分钟缓存；上游偶发不可用时会有重试。若返回的地址字段为空，表示该 IP 未被收录（内网地址、保留段或新分配段都可能出现这种情况），不是接口故障。
黄金行情
GET /api/public/gold/quotations
GET /api/public/gold/market
第一个返回最新报价快照，第二个返回当日分时数据。数据来源于上海黄金交易所的 Au99.99 现货，服务端做了短时缓存（默认 60 秒）以降低对上游的压力，因此不适合用作秒级交易参考。
前端实时金价页面以 30 秒间隔轮询，页面上标注了数据延迟。
站点配置
GET /api/public/configs/site-config
返回站点的全部键值配置，包括标题、副标题、备案号、联系邮箱、响应时间等。前台页面用它渲染页脚与「联系我们」页，后台改动后无需重启即可生效。
页面配置
GET /api/public/configs/page-configs
GET /api/public/configs/page-configs/tree
分别返回扁平列表与树形结构，用于首页的工具分组展示。
知识库
GET /api/public/kb/categories
GET /api/public/kb/articles
GET /api/public/kb/articles/{slug}
分类列表、已发布文章列表、单篇文章详情。文章正文是 Markdown。
sitemap
GET /api/public/sitemap-articles.xml
知识库文章的 sitemap 分片，供搜索引擎抓取。站点主 sitemap（/sitemap.xml）是一个索引，同时引用本站静态页分片与这个文章分片。
调用注意事项
- 都是 GET 接口，返回 JSON（sitemap 接口返回 XML）
- 有频率限制与缓存，不要高频轮询；做批量查询请自带节流
- 上游数据本身有延迟，涉及实时决策的场景请以权威数据源为准
- 接口可能调整，如果你的项目依赖它们，建议做容错处理
遇到问题可以在联系我们页面留言。