Teste a API do Localizador de Preços de Gasolina do Zyla API Hub com Postman

Você precisa enviar um recurso esta semana que mostre os preços reais de gasolina perto de um código postal e, se um usuário tocar em um posto, retorne detalhes como coordenadas, horários e comodidades. Ao final deste guia, você terá uma solicitação funcional no Postman (e código) contra a API do Localizador de Preços de Gasolina no Zyla API Hub, além de um caminho para chamar a mesma API de um agente de IA compatível com MCP.

O que a API do Localizador de Preços de Gasolina fornece

A API do Localizador de Preços de Gasolina retorna preços atualizados de postos de gasolina para um determinado código postal e tipo de combustível. Ela também fornece metadados detalhados do posto (endereço, coordenadas, telefone, horários de funcionamento, comodidades, combustíveis e mais) quando você procura um posto pelo seu ID. Isso é uma solução prática para aplicativos de roteamento, painéis de entrega, painéis de frota e qualquer aplicativo de consumo que ajude os usuários a encontrar gasolina mais barata nas proximidades.

Ilustração: Teste a API do Localizador de Preços de Gasolina do Zyla API Hub com Postman

Todas as chamadas passam pelo Zyla API Hub: uma conta, uma chave, um modelo de assinatura. Você se autentica com um simples cabeçalho de token bearer. O marketplace hospeda mais de 10.000 APIs públicas que você pode navegar em zylalabs.com.

Começando no Zyla API Hub

Abra a lista de APIs para a API do Localizador de Preços de Gasolina no Zyla. Clique em Assinar (ou Começar Teste Gratuito onde disponível) para obter sua chave de API, depois chame os endpoints usando o formato do cabeçalho de Autorização mostrado abaixo. As assinaturas do Zyla são baseadas em cota (não pagas por chamada). Para esta API, o primeiro nível de assinatura oferece um teste de 7 dias ou 50 solicitações; não há Plano Gratuito. Verifique a página da API para opções de acesso e preços atuais.

Quando você estiver pronto para testar, faça login e pegue sua chave. Se você ainda não tem uma conta, pode Registrar em um minuto.

Autenticação

Use sua chave Zyla com um cabeçalho de token bearer:

Cabeçalho: Authorization: Bearer YOUR_API_KEY

Não há corpo de solicitação para os endpoints cobertos aqui. Parâmetros de consulta são usados quando necessário (documentados abaixo).

Endpoints que você usará

1) Obter Preços

Método: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
Descrição: Passe um código postal e um tipo de combustível para recuperar os preços dos postos de gasolina para essa área ou os postos mais próximos nas proximidades.

Parâmetros de consulta obrigatórios:

zip (número): e.g., 90001
type (string): e.g., regular

Configuração do Postman

Método: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
Params: zip=90001, type=regular
Headers: Authorization: Bearer YOUR_API_KEY
Enviar solicitação

Exemplo oficial de cURL

curl -s -X GET "https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices?zip=90001&type=regular" \
-H "Authorization: Bearer YOUR_API_KEY"

Exemplo de resposta oficial

{
"status": "success",
"zip": "77478",
"gas_type": "regular",
"currency": "USD",
"gas_prices": [
{
"average": "$2.60",
"lowest": "$2.07"
},
{
"station": "Shell",
"address": "2995 Dulles Ave Missouri City, TX",
"price": "$2.33"
},
{
"station": "Sam's Club",
"address": "351 SH-6 Sugar Land, TX",
"price": "$2.33"
},
{
"station": "Murphy Express",
"address": "7520 Highway 90 A. Sugar Land, TX",
"price": "$2.36"
},
{
"station": "WB Food Mart",
"address": "13003 W Bellfort Ave Sugar Land, TX",
"price": "$2.38"
},
{
"station": "Shell",
"address": "1750 Williams Trace Blvd Sugar Land, TX",
"price": "$2.39"
},
{
"station": "Valero & Circle K",
"address": "13445 W Airport Blvd Sugar Land, TX",
"price": "$2.59"
},
{
"station": "Chevron",
"address": "13811 SW Fwy Sugar Land, TX",
"price": "$2.69"
},
{
"station": "Texaco",
"address": "7800 US-90 A Sugar Land, TX",
"price": "$2.69"
},
{
"station": "Exxon",
"address": "1740 Dulles Ave Sugar Land, TX",
"price": "$2.79"
},
{
"station": "Shell",
"address": "13747 SW Fwy Sugar Land, TX",
"price": "$2.79"
}
]
}

Quais campos você realmente usará

status: string para confirmar sucesso.
zip: o código postal usado na pesquisa.
gas_type: o tipo de combustível solicitado.
currency: moeda para preços (USD no exemplo).
gas_prices: array que pode começar com um objeto agregado (média, menor), seguido por entradas de nível de posto com posto, endereço, preço.

Notas práticas:

Os preços são strings formatadas como moeda (por exemplo, “$2.33”), não números brutos. Se você precisar de valores numéricos, remova os símbolos de moeda antes dos cálculos.
As unidades são dólares por galão quando a fonte de dados indica isso (veja Dados do Posto para o contexto da unidade).
O array pode combinar estatísticas agregadas e linhas de postos. Seu parser deve lidar com ambas as formas de maneira elegante.

2) Dados do Posto

Método: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data
Descrição: Retorna dados detalhados para um posto. Você deve especificar um ID de posto. Você pode obter o ID do endpoint Obter Preços.

Parâmetros: A lista instrui você a especificar um ID de posto, mas não documenta as chaves dos parâmetros. Os chamadores devem consultar a página da API sobre como fornecer o ID do posto ao invocar este endpoint. Não invente nomes de parâmetros; envie apenas o cabeçalho de Autorização até que você tenha o formato exato do parâmetro documentado no console ou na documentação da sua conta.

Exemplo oficial de cURL

Exemplo de resposta oficial

Quais campos você realmente usará

data.station_id, data.name: identificam o posto.
data.address.*: linhas renderizáveis e cidade/estado/ZIP para UI e alternativas de geocodificação.
data.coordinates.lat/lng: colocação precisa no mapa.
data.open_status, data.opening_hours: mostram se está aberto e horários típicos.
data.rating.overall, data.rating.count: renderizam estrelas e contagens de avaliações.
data.currency, data.price_unit: exibem unidades corretamente (dollars_per_gallon).
data.fuels: filtram ou destacam tipos de combustível suportados.
data.amenities: destacam recursos úteis (por exemplo, Pague no Posto, Caixa Eletrônico).
data.nearby_station_ids: encadeiam solicitações para sugerir alternativas.

Código para copiar e colar: exemplo em Python para Obter Preços

Este exemplo chama o endpoint Obter Preços com os parâmetros de consulta documentados e analisa tanto as entradas agregadas quanto as de postos. Substitua YOUR_API_KEY antes de executar.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices"
params = {
"zip": "90001",
"type": "regular"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

if data.get("status") != "success":
raise SystemExit(f"API retornou não sucesso: {data}")

print(f"ZIP: {data.get('zip')} | Combustível: {data.get('gas_type')} | Moeda: {data.get('currency')}")
stations = []
for entry in data.get("gas_prices", []):
if "station" in entry:
stations.append({
"station": entry.get("station"),
"address": entry.get("address"),
"price": entry.get("price")
})
else:
# Linha agregada (por exemplo, média/menor)
avg = entry.get("average")
low = entry.get("lowest")
if avg or low:
print(f"Agregado: média={avg}, menor={low}")

print("Principais postos:")
for s in stations[:5]:
print(f"- {s['station']} | {s['price']} | {s['address']}")

Testando rapidamente com Postman

Se você prefere Postman ao cURL enquanto explora, aqui está um caminho rápido para uma execução bem-sucedida:

Crie uma nova aba de solicitação GET.
Defina a URL como https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices.
Abra a aba Params e adicione:
- zip = 90001
- type = regular
Abra a aba Headers e adicione:
- Authorization = Bearer YOUR_API_KEY
Envie a solicitação e confirme um 200 OK com a resposta JSON mostrada acima.

Em seguida, configure uma segunda aba GET apontando para https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data e inclua o mesmo cabeçalho de Autorização. A lista observa que você deve especificar um ID de posto para este endpoint; consulte seu console/documentação do Zyla para o formato exato do parâmetro quando estiver pronto para buscar um posto específico pelo ID.

Notas de implementação do mundo real

Unidades e moeda: O endpoint Dados do Posto relata explicitamente moeda e price_unit como dollars_per_gallon. Trate os preços de Obter Preços como strings de moeda; formate-os de maneira consistente se você misturar fontes de dados em seu aplicativo.
Analisando a lista de gas_prices: Seu código deve antecipar que as primeiras uma ou duas entradas podem ser linhas agregadas (média, menor), seguidas por linhas de postos com posto, endereço, preço.
Estratégia de cache: Armazene em cache respostas bem-sucedidas por (zip, type) para reduzir buscas repetidas. Um TTL curto (por exemplo, 5–15 minutos) é geralmente sensato para preços de combustível; ajuste conforme suas necessidades de UX.
Alternativas elegantes: Se as informações granulares de um posto não estiverem presentes em Obter Preços, use Dados do Posto (com o ID do posto) para enriquecer coordenadas, horários, comodidades e sugestões nas proximidades.
Quotas: Os planos do Zyla são baseados em assinatura + cota, não pagas por chamada. O primeiro nível aqui é um teste de 7 dias ou 50 solicitações. Fique de olho no seu uso e agrupe chamadas sempre que possível.

Chamando a API de um agente de IA via MCP

Se você estiver usando um cliente compatível com MCP (Claude Code, Cursor, Windsurf e outros), pode direcionar chamadas através do endpoint MCP do Zyla. Aponte suas ferramentas de agente para:

MCP

Forneça sua chave de API Zyla onde seu cliente MCP a espera (o endpoint aceita um parâmetro de consulta apikey; siga a configuração do seu cliente MCP para segredos). Dentro do agente, invoque os endpoints da API do Localizador de Preços de Gasolina exatamente como mostrado acima (incluindo o cabeçalho Authorization: Bearer YOUR_API_KEY e os parâmetros de consulta documentados para Obter Preços). Mantenha as mesmas URLs do Hub:

Obter Preços: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
Dados do Posto: https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data

Isso permite que seu agente busque preços de gasolina e, em seguida, aprofunde-se nos detalhes do posto dentro do seu ambiente de codificação sem sair do editor.

Casos de uso comuns que você pode enviar esta semana

Widget “Encontre gasolina barata perto de mim”: Ao carregar a página, pegue o código postal e tipo de combustível do usuário, chame Obter Preços e renderize os cinco preços mais baixos com endereços.
Sobreposição de mapa para motoristas: Use Obter Preços para listar candidatos, depois chame Dados do Posto para o posto selecionado para fixar coordenadas precisas e exibir comodidades e horários.
Recurso de orçamento de combustível: Analise as linhas agregadas “média” e “menor” para estimar os custos de combustível da viagem e as economias potenciais por posto.
Sugestões alternativas: Use nearby_station_ids de Dados do Posto para sugerir alternativas se um posto estiver ocupado ou temporariamente fechado.

Onde encontrar esta API e sua conta

Navegue pela API do Localizador de Preços de Gasolina no Zyla: API do Localizador de Preços de Gasolina. Você também pode explorar mais de 10.000 APIs públicas em zylalabs.com e testá-las com a mesma chave e estrutura de assinatura.

FAQ

Como eu me autentico?
Inclua o cabeçalho Authorization: Bearer YOUR_API_KEY para cada solicitação.

Quais parâmetros são obrigatórios para Obter Preços?
zip (número) e type (string). Exemplo: zip=90001 e type=regular.

Como eu obtenho detalhes do posto, como coordenadas e comodidades?
Use o endpoint Dados do Posto. Você deve especificar um ID de posto. Obtenha o ID de Obter Preços, depois chame Dados do Posto conforme documentado na página da API.

Quais são os preços e limites?
O Zyla usa assinatura + cota, não pagas por chamada. Para esta API, o primeiro nível é um teste de 7 dias ou 50 solicitações e não há Plano Gratuito. Verifique a página da API para planos atuais.

Posso chamar esta API de um agente de codificação de IA?
Sim. Use o endpoint MCP do Zyla em seu cliente compatível com MCP, configure sua chave de API e chame as mesmas URLs do Hub mostradas acima.

Pronto para testar com sua própria chave no Postman e enviar a integração? Crie sua conta agora: Registrar, assine a API do Localizador de Preços de Gasolina e faça sua primeira solicitação em minutos.