MarkUDown
认证 — MarkUDown 网页抓取 API 文档
身份验证
所有请求都需要在 Header 中传递 API 密钥。
Header
X-API-KEY: your-api-key从控制台获取密钥。保持私密 — 切勿在前端代码中暴露。
错误响应
| 状态码 | 含义 |
|---|---|
| 401 | 缺少 API 密钥 |
| 403 | 额度不足或没有有效套餐(需升级) |
| 429 | 超过速率限制(套餐限制;未注册的密钥为每天 20 次请求) |
| 402 | 因付款失败订阅已暂停 — 请更新付款方式 |
速率限制
每个数字表示每个 API 密钥每分钟对该端点的最大请求数。分钟按 UTC 时钟的整分钟计算,因此计数在每分钟开始时重置。超过限制时,API 返回 429。只有发起请求的 POST 计数——轮询 GET /api/<endpoint>/{id} 以及列出或删除监控都不计数。
| 端点 | Free | Basic | Intermediate | Professional |
|---|---|---|---|---|
| /api/scrape | 10 | 20 | 100 | 1000 |
| /api/crawl | 1 | 3 | 10 | 50 |
| /api/map | 10 | 10 | 20 | 100 |
| /api/extract | 3 | 10 | 20 | 100 |
| /api/create-schema | 10 | 10 | 20 | 100 |
| /api/prompt-extract | 3 | 10 | 20 | 100 |
| /api/batch-scrape | 1 | 3 | 10 | 50 |
| /api/search | 3 | 10 | 20 | 100 |
| /api/screenshot | 5 | 10 | 50 | 200 |
| /api/pdf-to-markdown | 5 | 10 | 50 | 200 |
| /api/rss | 5 | 10 | 20 | 100 |
| /api/change-detection | 3 | 10 | 20 | 100 |
| /api/deep-research | 1 | 3 | 5 | 20 |
| /api/agent | 1 | 3 | 10 | 30 |
| /api/smart-extract | 1 | 5 | 15 | 50 |
| /api/rank | 3 | 10 | 30 | 100 |
| /api/dataset | 1 | 3 | 10 | 30 |
| /api/monitor | 1 | 5 | 20 | 100 |
未注册到账户的密钥使用 Free 档限制,按客户端 IP 计数,另外还受免费层每天 20 次请求的上限约束。