挑战课程 · 任一编码 Agent + FastAPI

一个经过验证的 Web API

一门挑战课程——一个 FastAPI 片段服务在六处违反了自己的 spec。修好 app 直到提供的契约套件全绿,再为 spec 没钉死的行为写测试,并证明它们能抓住植入的回归。

进阶5 个挑战2–3 hours完成基础路线者Pro(订阅)课程徽章:已验证 API审核于 2026-09-12中文 + EnglishPro

把这一句话粘贴给你的 Agent,即可开始:

Read https://flypython.com/skills/flypython/SKILL.md and start the FlyPython course `dt-webapi`.

需要一个能执行命令并联网的编码 Agent(纯网页聊天 AI 做不了)。Agent 会用一次性授权链接为你授权、 自己取回课程文件——你不需要下载任何东西。 还没装 FlyPython Skill选你工具对应的工具课 →

概览

学到什么一个可用的 API 端点:输入校验、稳定的错误结构、打真实请求的测试——端到端验证。
适合谁完成基础路线者 · PATH 中有 Python 3.11 或更新版本
时长与费用2–3 hours · Pro 订阅

题目

五课,每课一个检查点

每课都以一条要运行的命令和必须脱稿回答的问题收尾。English syllabus →

01

测试就是契约

读提供的 spec 套件,把每个失败映射到 app 的一个洞。

检查点 + 预期证据
02

定义未覆盖的表面

列出 spec 没钉死的行为——那份清单就是你的套件。

检查点 + 预期证据
03

按 spec 修好 app

状态码、校验、错误形状、DELETE 语义——对着只读 spec 修到全绿。

检查点 + 预期证据
04

扩展套件、抓住回归

你的测试在你的 app 上变绿、在植入 bug 的变体上变红。

检查点 + 预期证据
05

给你自己的 API 写契约测试

把契约测试循环迁移到你真在跑的服务上。

检查点 + 预期证据

开始

Pro 课程——订阅有效即可开始解题

Pro用 Agent 掌握 Python 开发工具链

属于「用 Agent 掌握 Python 开发工具链」路线

本课程的文件同样经上方入口语句到达——订阅生效后,授权链接会自动附带 pro:files 权限。只有订阅有效期间才能记录认领。

永久免费

免费课程不会缩水

基础路线与开源仓库里的每门社区课程永远免费,六门 Agent 工具课也全部免费——Pro 资助付费路线的建设,不会把公共资源收进收费墙。

场景皮肤

同样的技能,你熟悉的领域

三个皮肤走同一份代码和同一套测试。开课前选一个最贴近你工作的。

scenario/snippets-api/app.py

片段 API

客户接入了你的片段服务——然后报回两个'不可能'的 bug。

验证

“完成”由什么决定

提供的 spec 套件钉住 API 契约;你自己的套件必须在你的 app 上变绿、在植入 bug 的变体上变红。

python verify.py  # 在课程文件夹运行:打印检查点状态 + 认领码

把这套方法带回你的项目

第 5 课把工作流——而不是代码——迁移到你真正拥有的一个脚本上:三行任务契约、一个从红变绿的新测试、 一份写明测试不能证明什么的记录。同一个循环在AI Coding 工作方法指南中有完整描述, 并可由可运行示例练习。

认领你的证据

检查点通过后,python verify.py 会打印确定性认领码。 完成授权的 Agent 会替你一次性批量提交;手动提交则粘贴到进度页—— 每个检查点 10 分,集齐五个获得 已验证 API 课程徽章。认领码是自我声明的证据,不是证书。

验证不能证明什么

通过课程套件只证明被锚定的行为在测试输入上成立——不等于明天的数据也对,不等于生产性能达标, 在你为自己的项目写下契约之前,也不代表你项目里的任何事。仓库测试是证据,不是你的结果。