Operações GET

Introdução ao FastAPI

Matt Eckerle

Software and Data Engineering Leader

Revisão da operação GET

Protocolo HTTP - vários tipos de operações

GET é a mais comum

Exemplo: https://www.google.com:80/search?q=fastapi

As partes-chave de uma requisição GET são:

Host, ex.: www.google.com
Porta, ex.: 80 (padrão)
Caminho, ex.: /search
Query string, ex.: ?q=fastapi

Operação GET no FastAPI

A aplicação FastAPI mais simples:

from fastapi import FastAPI


# Instanciar o app
app = FastAPI()


# Tratar GET para a raiz
@app.get("/")
def root():
    return {"message": "Hello World"}

¹ https://fastapi.tiangolo.com/tutorial/first-steps/

Usando o cliente web cURL

Principais opções do cURL:

$ curl -h
Usage: curl [options...] <url>
 -v, --verbose               Make the operation more talkative
 -H, --header <header/@file> Pass custom header(s) to server
 -d, --data <data>           HTTP POST data

Exemplo de uso:

$ curl http://localhost:8000
{"message":"Hello World"}

Parâmetros de query

Novo endpoint:

Caminho: "/hello"
Parâmetro de query: "name"
- Valor padrão: "Alan"

@app.get("/hello")
def hello(name: str = "Alan"):
    return {"message": f"Hello {name}"}

Nome ausente na requisição: Terminal mostrando uma requisição curl sem nome. A resposta é "Hello Alan."

Nome na requisição: Terminal mostrando uma requisição curl com nome. A resposta é "Hello Steve."

Vamos praticar!

Introdução ao FastAPI