您的第一个 API 端点
学习创建简单的 GET 端点、定义路由并返回基本的 JSON 响应。
您的第一个 API 端点 是 CoddyKit 上的免费 FastAPI Backend Development Bootcamp 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 FastAPI Backend Development Bootcamp 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 FastAPI Backend Development Bootcamp 课程共包含 4 节课。
本课时的部分内容尚未翻译,以英文显示。
What's an API Endpoint?
An API endpoint is a specific URL your API exposes — an address that receives requests and returns a service. We start with GET, used to fetch data.
Your FastAPI Application
Every app starts from a FastAPI instance, conventionally named app. This object is the core where all your routes and logic live.
from fastapi import FastAPI
app = FastAPI()
# This 'app' object is where your API lives!Defining Routes with Decorators
FastAPI uses decorators to bind a URL path to a function. @app.get("/") says: on a GET to the root path, run the function below.
Your First 'Hello World' Endpoint
Here is the classic API Hello World — a single GET endpoint at /. Run it and hit the root in your browser or Postman.
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"message": "Hello, CoddyKit!"}
# To run: Save as main.py, then 'uvicorn main:app --reload'Running Your FastAPI App
Run your app with Uvicorn: uvicorn main:app --reload finds app in main.py and auto-restarts whenever you edit code.
FastAPI's JSON Magic
FastAPI's JSON magic: return a Python dict or list and it serializes to a JSON response automatically — no manual conversion needed.
Returning Structured JSON Data
Return a richer Python dict and FastAPI ships it as structured JSON. Here, an endpoint hands back full product details.
from fastapi import FastAPI
app = FastAPI()
@app.get("/product")
def get_product_info():
return {
"id": "CK001",
"name": "CoddyKit Pro Course",
"price": 49.99,
"available": True
}
# Run with: uvicorn main:app --reload
# Access this endpoint at /productCreating Multiple Endpoints
An API has many endpoints, each for a different resource. Define as many as you need on one app — here, two distinct GET routes.
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"message": "Welcome to our API!"}
@app.get("/items")
def get_items():
return [
{"id": 1, "name": "Laptop"},
{"id": 2, "name": "Mouse"},
{"id": 3, "name": "Keyboard"}
]
# Run with: uvicorn main:app --reload
# Access at / and /itemsEndpoint Naming Conventions
Good endpoint naming keeps an API readable: plural nouns for collections, short lowercase hyphenated paths, and no verbs — the HTTP method implies the action.
Quick Check
Which of the following code snippets correctly defines a FastAPI GET endpoint at the path /status that returns a JSON object {"status": "OK"}?
Lesson Summary
Solid! You built endpoints with decorators, returned dicts as JSON, and ran the app via Uvicorn. Next: making routes dynamic with URL data.
常见问题解答
「您的第一个 API 端点」课时是免费的吗?
是的 — 「您的第一个 API 端点」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 FastAPI Backend Development Bootcamp 课程的其余内容,请升级到 CoddyKit PRO。 FastAPI Backend Development Bootcamp 课程共包含 4 节课。
「您的第一个 API 端点」这节课中我会学到什么?
学习创建简单的 GET 端点、定义路由并返回基本的 JSON 响应。 你通过在浏览器中直接运行的动手代码来练习 FastAPI Backend Development Bootcamp,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 FastAPI Backend Development Bootcamp 需要有经验吗?
无需任何先前经验。CoddyKit 上的 FastAPI Backend Development Bootcamp 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。
「您的第一个 API 端点」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 FastAPI Backend Development Bootcamp 课中编写并运行代码吗?
能。每节 FastAPI Backend Development Bootcamp 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- FastAPI 简介与设置
- 您的第一个 API 端点
- 路径参数与查询参数
- 使用 Swagger UI 构建交互式 API 文档