O que são parâmetros de consulta (query)?

Os parâmetros de consulta (query parameters) são pares chave-valor adicionados à URL após o símbolo ?. São usados para transmitir informações adicionais ao servidor durante as requisições HTTP (geralmente GET).

Exemplo de URL com parâmetros de consulta: https://example.com/api/items?category=electronics&sort=price_asc

Aqui:

• category=electronics — primeiro parâmetro, chave category, valor electronics.
• sort=price_asc — segundo parâmetro, chave sort, valor price_asc.
• Os parâmetros são separados por um esperanto (&).

Objetivos dos parâmetros de consulta:

• Filtragem de dados: Seleção de dados com base em certos critérios.
• Ordenação de dados: Definir a ordem em que os dados são recebidos.
• Navegação por páginas (paginação): Especificar o número da página e a quantidade de elementos por página.
• Transmissão de identificadores: Identificação de recursos ou usuários.
• Instruções adicionais para o servidor: Por exemplo, quais campos retornar na resposta.

No lado do servidor, a aplicação analisa esses parâmetros e os usa para formar a resposta.

Na automação de testes, os parâmetros de consulta são frequentemente usados para:

• Gerar dados de teste com diferentes condições.
• Verificar a lógica da API com diferentes entradas.
• Testar filtragem, ordenação e paginação no backend.

Exemplo de uso de parâmetros de consulta em Python com a biblioteca requests:

# Envio de requisição GET com parâmetros
import requests

url = "https://httpbin.org/get"
params = {
    "param1": "value1",
    "param2": "value2"
}

response = requests.get(url, params=params)

# Verificação do código de status
print(f"Código de estado: {response.status_code}")

# Exibir os parâmetros recebidos
print(f"Parâmetros recebidos: {response.json().get('args')}")