Documentação interativa da API com Swagger UI
Explore a documentação interativa automática gerada pelo FastAPI, personalize-a com metadados e tags e use-a para testar seus endpoints diretamente no navegador.
Documentação interativa da API com Swagger UI é uma aula grátis de FastAPI Backend Development Bootcamp no CoddyKit. Esta é a aula 4 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.
Docs for Free
FastAPI's standout perk: automatic interactive docs. From your type hints and models it builds an OpenAPI schema and serves Swagger UI at /docs and ReDoc at /redoc.
Where Docs Come From
Both doc UIs render one OpenAPI JSON spec that FastAPI builds from your routes, params, and models. View the raw spec at /openapi.json.
App-Level Metadata
Pass app metadata — title, description, version — to the FastAPI constructor to brand your docs.
from fastapi import FastAPI
app = FastAPI(
title='Bookstore API',
description='Manage books and orders',
version='1.0.0',
)Summaries and Descriptions
Give each route a summary plus a docstring. The docstring becomes the long description in the docs and even supports Markdown.
@app.get('/books', summary='List all books')
async def list_books():
"""Return **every** book in the catalog."""
return booksGrouping with Tags
Use tags to group related endpoints into collapsible sections, keeping large APIs tidy in the docs.
@app.get('/users', tags=['users'])
async def list_users():
return users
@app.get('/books', tags=['books'])
async def list_books():
return booksDocumenting Responses
Declare alternate responses with the responses parameter so the docs list every status code a client might get, like a 404.
@app.get('/books/{id}', responses={404: {'description': 'Book not found'}})
async def get_book(id: int):
return books[id]Example Values
Add examples via Pydantic Field so Swagger UI pre-fills realistic values, making Try it out far easier.
from pydantic import BaseModel, Field
class Book(BaseModel):
title: str = Field(examples=['Dune'])
pages: int = Field(examples=[412])Building OpenAPI Mentally
The OpenAPI schema is just structured data. Here is a tiny Python sketch of grouping routes by tag to make that concrete.
routes = [
{'path': '/users', 'tag': 'users'},
{'path': '/books', 'tag': 'books'},
{'path': '/orders', 'tag': 'books'},
]
grouped = {}
for r in routes:
grouped.setdefault(r['tag'], []).append(r['path'])
print(grouped)Try It Out
In Swagger UI, hit Try it out, fill params, and Execute. You get a real request, the curl command, and the live response — no client code needed.
Customizing or Disabling Docs
Change the doc URLs or disable docs entirely (handy for production) right from constructor arguments.
app = FastAPI(docs_url='/api-docs', redoc_url=None)
# Disable both:
# app = FastAPI(docs_url=None, redoc_url=None)Why It Matters
Because docs are generated from your code, they stay accurate and never drift like handwritten ones — cutting friction for frontend teams and API consumers.
Quick Check
Where does FastAPI get the information it uses to build the interactive docs?
Recap
You explored FastAPI's automatic docs: Swagger and ReDoc from the OpenAPI spec, metadata, tags and examples, and how to customize or disable them.
Perguntas Frequentes
A aula “Documentação interativa da API com Swagger UI” é grátis?
Sim — o texto completo de “Documentação interativa da API com Swagger UI” é 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 “Documentação interativa da API com Swagger UI”?
Explore a documentação interativa automática gerada pelo FastAPI, personalize-a com metadados e tags e use-a para testar seus endpoints diretamente no navegador. 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 4 de 4.
Quanto tempo leva a aula “Documentação interativa da API com Swagger UI”?
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