码上见 GEO API
GEO API 可从脚本、自动化流程或 AI 工具发布单个 HTML 页面，并返回可分享的预览链接。接口当前不接收 JSON 包装对象，而是接收原始 HTML 请求体。
请求
POST https://www.htmline.cc/api/geo
| 字段 | 说明 |
|---|---|
| 请求体 | 原始 UTF-8 HTML 文本，20 字节至 3 MB。 |
| Content-Type | 建议使用 text/html; charset=utf-8。 |
| X-Title | 可选，页面标题，最多 200 个 Unicode 字符；未提供时尝试从 HTML 的 title 标签提取。 |
| X-Access-Code | 可选，4 位数字；设置后页面需要该访问码，接口响应会返回访问码。 |
curl 示例
curl -X POST 'https://www.htmline.cc/api/geo' \
-H 'Content-Type: text/html; charset=utf-8' \
-H 'X-Title: 产品演示原型' \
--data-binary '<!doctype html><html><body><h1>Hello</h1></body></html>'添加访问码示例：-H 'X-Access-Code: 1234'。实际使用时请勿把访问码写入公开日志或代码仓库。
成功响应
创建成功时返回 HTTP 201 和 JSON 数据，包含链接、过期时间、提示文案；设置访问码时还会返回 access_code。过期时间格式为 YYYY-MM-DD HH:mm，响应中不包含时区字段。
{
"url": "https://www.htmline.cc/p/页面ID",
"expires_at": "2026-10-03 12:00",
"tagline": "码上见 — 一键预览你的 HTML，即刻分享，无需部署",
"expiry_notice": "此页面将在 2026-10-03 12:00 后自动过期"
}限制与错误
- 默认过期时间为创建后 5 天；服务配置可调整默认天数。
- 每个 IP 默认每分钟最多 10 次、每天最多 100 次 GEO API 请求。
- 请求体不足 20 字节、超过 3 MB、非有效 UTF-8 或访问码格式错误时，请求会失败。
- 请勿提交敏感信息。未设置访问码的页面对持有链接的人开放，页面到期后自动清理。
交互式粘贴发布请使用 在线工具；完整使用步骤见 HTML 预览与分享指南。