# 快速开始

PageDrop 托管 HTML / Markdown / TXT 单文件，生成带有效期、密码、访问次数上限、
一次性、自定义短链或指定版本等策略的分享链接。控制台里能点出来的每一个操作，都同样
可以通过 REST API、MCP 服务（面向 AI 客户端）或官方 CLI 自动化完成。

## 60 秒上手

1. **创建账号**：到 `http://117.72.193.223:10180/signup`（或你自己的部署地址）注册。
2. **上传第一份文件**：进入 `/files`，拖拽一个 `.html` / `.md` / `.txt` 文件即可。
3. **拿到分享链接**：在文件行点 "创建分享"，或在上传时同时附带一个 `share` 段，一次请求搞定。
4. **（可选）创建 API token**：去 `/developers/tokens` 生成，用于以编程方式驱动 PageDrop。

## 三种集成方式

| 方式 | 适用场景 | 文档 |
|---|---|---|
| **REST API** | 通用脚本、CI、服务端到服务端 | [API 参考](/developers/api) |
| **MCP 服务** | Claude Code / Cursor / Claude Desktop 等任何支持 MCP 的 AI 客户端 | [MCP 接入指南](/developers/mcp) |
| **Skill** | 一行复制即可让 AI 助手学会调度 PageDrop 工具的"行为说明书" | [Skill](/developers/skill) |
| **CLI** | 在终端里直接 `pagedrop upload ./report.md` | [CLI](/developers/cli) |
| **Webhooks** | 访问 / 举报等事件发生时推送到你的服务器 | [Webhooks](/developers/webhooks) |

## 一次完整的端到端示例（curl）

```bash
BASE=http://117.72.193.223:10180
TOKEN=pd_XXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY

# 1. 验证 token 可用
curl -s -H "Authorization: Bearer $TOKEN" $BASE/api/v1/me | jq

# 2. 上传文件并在同一次请求里创建 7 天分享
curl -s -H "Authorization: Bearer $TOKEN" \
  -F "file=@notes.md;type=text/markdown" \
  -F 'share={"expiresInDays":7}' \
  $BASE/api/v1/files

# 响应包含 { file: {...}, share: {...}, url: "<完整分享 URL>" }
```

## 交互式 Playground

如果你更习惯点击而不是 curl，可以打开 [Playground](/developers/playground)：
粘上你的 token（或直接复用当前已登录的 session），就能在浏览器里把每个接口试一遍。

## 把整站文档喂给 AI

`/developers/*` 下的每一页都有对应的 `.txt` 双胞胎，返回去除 HTML 外壳的原始 markdown，
方便你贴给 ChatGPT / Claude / Cursor 等 AI：

- 总目录：`/llms.txt`
- 单页：`/developers/api.txt`（任何 slug 都行）