# PageDrop developer documentation

Base URL: https://pagedrop.space
API root: /api/v1
OpenAPI spec: /api/openapi.json
Interactive playground: /developers/playground
Token management: /developers/tokens

## Pages

- 快速开始 · Getting started — /developers/getting-started — 60 秒上手 + 选择集成方式（REST / MCP / Skill / CLI / Webhook）
  raw text: /developers/getting-started.txt
- REST API — /developers/api — /v1/* 端点完整参考 + 错误码 + curl 例子
  raw text: /developers/api.txt
- MCP 接入 · Model Context Protocol — /developers/mcp — @pagedrop/mcp stdio / streamable HTTP 双模式，6 个 tool
  raw text: /developers/mcp.txt
- Skill 接入 — /developers/skill — @pagedrop/skill SKILL.md 模板 + 安装方法 + 示范脚本
  raw text: /developers/skill.txt
- CLI · pagedrop — /developers/cli — @pagedrop/cli 命令行客户端：login / upload / share / ls / rm
  raw text: /developers/cli.txt
- Webhooks — /developers/webhooks — share_visited / share_reported 事件 + HMAC-SHA256 签名 + 审计日志
  raw text: /developers/webhooks.txt

All endpoints under /v1 authenticate via Authorization: Bearer pd_<prefix>_<secret>.
Rate limit: 60 requests / minute / token; 429 with Retry-After when exceeded.
Error envelope: { error, code } with codes UNAUTHENTICATED / VALIDATION / NOT_FOUND /
RATE_LIMITED / OVER_QUOTA / INFECTED / SLUG_TAKEN / DUPLICATE / CONFLICT / INTERNAL.