Seu primeiro endpoint de API
Aprenda a criar endpoints GET simples, definir rotas e retornar respostas JSON básicas.
Seu primeiro endpoint de API é uma aula grátis de FastAPI Backend Development Bootcamp no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de FastAPI Backend Development Bootcamp, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de FastAPI Backend Development Bootcamp inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
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.
Perguntas Frequentes
A aula “Seu primeiro endpoint de API” é grátis?
Sim — o texto completo de “Seu primeiro endpoint de API” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de FastAPI Backend Development Bootcamp, atualize para CoddyKit PRO. O curso de FastAPI Backend Development Bootcamp inclui 4 aulas no total.
O que vou aprender em “Seu primeiro endpoint de API”?
Aprenda a criar endpoints GET simples, definir rotas e retornar respostas JSON básicas. Você pratica FastAPI Backend Development Bootcamp com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar FastAPI Backend Development Bootcamp?
Nenhuma experiência prévia é necessária. FastAPI Backend Development Bootcamp no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.
Quanto tempo leva a aula “Seu primeiro endpoint de API”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de FastAPI Backend Development Bootcamp?
Sim. Cada aula de FastAPI Backend Development Bootcamp inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Introdução ao FastAPI e configuração
- Seu primeiro endpoint de API
- Parâmetros de caminho e de consulta
- Documentação interativa da API com Swagger UI