htmlcode.fun for Agents

把单文件 HTML 页面，用最短路径上线

htmlcode.fun 不是传统静态站托管平台，而是一个面向单 HTML 内容的即时部署通道。对于演示页、落地页、临时说明页、二维码分享页、AI 生成页面，它比 GitHub + Vercel / Netlify 的链路更短、更直接。

部署接口

POST /api/deploy

内容格式

单个 HTML 字符串

节流限制

成功后冷却 10 秒

核心优势

轻量，不需要仓库、构建、框架配置或 CLI 登录。
快，直接提交 HTML 内容即可得到访问链接，单次上线接近秒级。
适合 Agent，返回结构化错误，便于自动重试和程序化控制。
可固定链接覆盖更新，使用 customCode + PATCH /api/deploy/content 可持续迭代同一链接。
自带二维码，天然适合分享、演示、活动页传播。

边界与限制

限制仅支持单个 HTML 内容，不是多文件项目托管平台。
限制最大 1 MB，复杂站点或大量内联资源不适合。
限制成功部署后有 10 秒冷却，不能连续高频秒发。
未知公开资料里未看到自定义域名绑定能力，当前更像站内短链平台。
不适合 React/Vue/Next 的工程化项目、CI/CD、多环境预览、回滚管理。

最佳实践方案

场景	建议	原因
临时活动页、说明页、分享页	直接用 `POST /api/deploy`	链路最短，速度最快。
固定页面长期迭代	启用 `enableCustomCode=true`	保证链接稳定，不需要反复更换 URL。
同一页面持续覆盖更新	用 `PATCH /api/deploy/content`	在同一 code 下更新内容，适合 Agent 反复修订。
AI 生成页面自动上线	先生成完整 HTML，再一次性提交	减少多次请求，规避冷却影响。
对外正式官网	优先选 Vercel / Netlify / GitHub Pages	更适合自定义域名、工程化、团队协作。

Agent 高效使用建议

始终发送 application/json，不要用 multipart。
把 CSS、JS 尽量内联，输出成一个可独立运行的 HTML 文件。
优先一次生成完整版本，避免频繁小修小补触发 10 秒冷却。
如果页面要长期维护，首次部署就指定 customCode。
处理 429 时读取 retryAfterSeconds 再重试，不要盲目重发。
控制文件体积，避免塞入大量 base64 图片。
给页面补齐 <title>、description、viewport 与 OG 标签。

推荐部署工作流

1. 生成单文件 HTML
2. 校验 title / description / viewport / OG
3. 选择 customCode（如需固定链接）
4. POST /api/deploy 首次发布
5. 保存返回的 code 与 url
6. 后续用 PATCH /api/deploy/content 覆盖更新
7. 如遇 429，按 retryAfterSeconds 重试

推荐请求示例

POST https://www.htmlcode.fun/api/deploy
Content-Type: application/json

{
  "filename": "index.html",
  "title": "htmlcode-fun-guide",
  "content": "<!doctype html>...完整 HTML...</html>",
  "enableCustomCode": true,
  "customCode": "htmlcode-fun-guide"
}