BUILT FOR YOUR WORKFLOW
从终端，到分享.
用一个简单的 HTTP 请求，把日志、代码和笔记接入你的工作流。
快速开始
无需账号即可创建片段。接口返回分享、Raw、编辑和删除链接，默认仅凭链接访问。
POST
https://paste.march7th.cn/api/paste也支持 /api/pastes；type 与 contentType 字段兼容。
cURL · macOS / Linux
curl -X POST https://paste.march7th.cn/api/paste \
-H 'Content-Type: application/json' \
-d '{
"title": "Hello, March7th",
"type": "markdown",
"visibility": "unlisted",
"content": "# Hello\n\n把灵感分享出去。",
"expiresIn": "7d",
"burnAfterRead": false
}'PowerShell 7
$body = @{ title = 'Hello, March7th'; type = 'markdown'; content = '# Hello'; expiresIn = '7d' } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri 'https://paste.march7th.cn/api/paste' -ContentType 'application/json; charset=utf-8' -Body ([Text.Encoding]::UTF8.GetBytes($body))请求 JSON
{
"title": "Hello, March7th",
"type": "markdown",
"visibility": "unlisted",
"content": "# Hello\n\n把灵感分享出去。",
"expiresIn": "7d",
"burnAfterRead": false
}请求字段
| 字段 | 类型 / 默认值 | 说明 |
|---|---|---|
| content | string · 必填 | UTF-8 编码最多 512 KiB（524,288 字节） |
| title | string · Untitled | 标题最多 200 个字符 |
| type / contentType | markdown | markdown / code / plain |
| language | string · 可选 | 代码语言，例如 typescript、python、json |
| visibility | unlisted | unlisted 仅凭链接访问；public 进入公开广场 |
| expiresIn | never | never / 1d / 7d / 30d |
| password | string · 可选 | 访问密码，最多 200 字符，不会放入分享 URL |
| burnAfterRead | boolean · false | 首次成功读取正文后链接失效，包含页面、JSON 和 Raw |
响应与管理
成功创建返回 HTTP 201。编辑和删除凭证仅在创建时返回，请单独保存；与别人分享时只发送 url。
响应示意 · 凭证使用占位符
{
"url": "https://paste.march7th.cn/p/example",
"raw": "https://paste.march7th.cn/raw/example",
"raw_txt": "https://paste.march7th.cn/raw/example.txt",
"raw_md": "https://paste.march7th.cn/raw/example.md",
"edit_url": "https://paste.march7th.cn/edit/example?key=YOUR_EDIT_TOKEN",
"delete_url": "https://paste.march7th.cn/delete/example?key=YOUR_DELETE_TOKEN"
}分享内容与管理凭证，分开保存。
编辑凭证可编辑或删除；删除凭证只能删除。服务端仅保存凭证哈希，遗失后无法找回。
读取与更新
| 方法与路径 | 行为 |
|---|---|
| GET /api/pastes/:slug | 读取 JSON；密码文档需要解锁 Cookie；成功读取会消费阅后即焚。 |
| GET /raw/:slug[.txt|.md] | UTF-8 纯文本，同样执行密码校验与阅后即焚。 |
| HEAD /raw/:slug HEAD /api/pastes/:slug | 只检查状态和访问权限，不读取正文，也不消耗阅读次数。 |
| POST /api/pastes/:slug/unlock | JSON 传入 password；成功后设置访问 Cookie，可配合 curl -c / -b 使用。 |
| PUT /api/pastes/:slug | 携带 x-edit-token 和完整的标题/正文等字段；省略 expiresIn 保留原有效期，空密码保留现有密码。 |
| DELETE /api/pastes/:slug | 携带 x-delete-token 或 x-edit-token。 |
为兼容旧链接，编辑/删除请求也接受 ?key=...。脚本推荐使用请求头传递管理凭证。
错误与限制
| HTTP 状态 | 含义 |
|---|---|
| 400 | 请求不合法，检查 JSON、类型和字节数 |
| 401 / 403 | 需要访问密码，或管理凭证不正确 |
| 404 | 片段不存在、已过期或不可访问 |
| 410 | 阅后即焚片段已被读取 |
| 429 | 请求过于频繁，请稍后重试 |
| 503 | 服务配置暂不可用 |
创建限制：每个客户端 IP 每分钟 5 次、每小时 50 次、每天 200 次。密码解锁每分钟 10 次、每小时 60 次，按客户端 IP 跨文档合计。受密码保护或阅后即焚的内容不会出现在公开广场。