踩坑宝典开放 API 投稿：curl 一键提交，无需登录踩坑宝典开放了 REST API 接口，一条 curl 命令就能

踩坑宝典开放 API 投稿：一条 curl 命令，把你的踩坑经验送进审核队列

一句话

踩坑宝典（worldcorner.xyz/pitfalls/）开放了 REST API。不需要 GitHub 账号，不需要打开浏览器，终端里敲一条 curl 就行。

用法

curl -X POST https://api.worldcorner.xyz/pitfall \
  -H "Content-Type: application/json" \
  -d '{
    "title": "一句话描述这个坑",
    "symptom": "看到了什么现象？",
    "root_cause": "根因是什么？",
    "fix": "怎么修的？",
    "avoid": "下次怎么避免？"
  }'

提交后自动创建 GitHub Issue，进入审核队列。审核通过即收录到踩坑宝典。

技术栈

组件	选型
计算	Cloudflare Workers（免费额度）
存储	GitHub Issues API
鉴权	无——完全开放
审核	Issue review → 脚本 → Hugo → push 部署

零服务器、零数据库、零运维。

两种投稿方式

API（本文）：终端 curl，适合开发者
网页表单：GitHub Issue 模板，适合任何人

链接

踩坑宝典：worldcorner.xyz/pitfalls/
API 文档：api.worldcorner.xyz/
网页投稿：github.com/zhao818/wor…

你踩过的每一个坑，都是别人少踩一次的理由。来投稿吧。