---
name: aibp-one-page
version: 1.0.0
description: "HTML 页面托管服务。上传 HTML 获取公网链接，支持密码保护。"
metadata:
  requires:
    bins: ["curl"]
  baseUrl: "https://onepage.aibp.me"
  key: "{{你的上传Key}} — 替换为你的Key"
---

# aibp-one-page — HTML 页面托管

上传 HTML，获得公网可访问的 URL。支持可选密码保护。

## 上传页面

```bash
curl -X POST https://onepage.aibp.me/api/upload \
  -H "Authorization: Bearer {{你的Key}}" \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Hello</h1>"}'
```

带密码：

```bash
curl -X POST https://onepage.aibp.me/api/upload \
  -H "Authorization: Bearer {{你的Key}}" \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Private</h1>", "password":"mypass"}'
```

返回值：

```json
{
  "id": "20260515-xxxxxxxx",
  "url": "https://onepage.aibp.me/p/20260515-xxxxxxxx",
  "hasPassword": false,
  "quota": { "used": 1, "max": 5000, "usedToday": 1, "maxPerDay": 1000 }
}
```

## 访问页面

- 无密码：直接打开 `url`
- 有密码：打开链接 → 输入密码 → 24h 免重复，或用 `?password=xxx` 参数

## 中文编码注意事项

使用 PowerShell 的 `ConvertTo-Json` 发送中文内容时，会强制将中文转成 `\uXXXX` 转义序列，而 OnePage 服务端无法正确解码回来，导致页面出现问号/乱码。

**解决方案**：用 Python 的 `ensure_ascii=False` 保留中文原文发送：

```bash
python3 -c "
import json, requests
data = {'html': '<h1>你好世界</h1>'}
requests.post('https://onepage.aibp.me/api/upload',
    headers={'Authorization': 'Bearer {{你的Key}}', 'Content-Type': 'application/json'},
    data=json.dumps(data, ensure_ascii=False).encode('utf-8'))
"
```

## 错误码

| 状态码 | 含义 |
|--------|------|
| 400 | html 字段为空 |
| 401 | Key 无效或缺失 |
| 403 | Key 已过期 / 密码错误 |
| 404 | 页面不存在 |
| 429 | 每日或总额度超限 |