An open API service indexing awesome lists of open source software.

https://github.com/renatorrocha/fuel-price-api


https://github.com/renatorrocha/fuel-price-api

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

        

# Fuel Price API


Nest Logo

## Descrição

Este é um projeto de API para gerenciamento de preços de combustíveis, construído com o framework [NestJS](https://nestjs.com). A API permite o upload de arquivos CSV contendo dados de preços de combustíveis e fornece endpoints para consultar esses dados.

## Configuração do Projeto

Para configurar o projeto, siga os passos abaixo:

### Pré-requisitos

- Node.js (versão 14 ou superior)
- pnpm (gerenciador de pacotes)

### Instalação

```bash
$ pnpm install
```

## Compilar e Executar o Projeto

```bash
# Modo de desenvolvimento
$ pnpm run start

# Modo de observação
$ pnpm run start:dev

# Modo de produção
$ pnpm run start:prod
```

## Endpoints da API

### Upload de CSV

- **POST** `/fuel/upload-csv`
- Permite o upload de um arquivo CSV contendo dados de preços de combustíveis.

### Consultar Preços

- **GET** `/fuel/prices`
- Retorna todos os preços de combustíveis disponíveis.

### Buscar Preços

- **GET** `/fuel/search`
- Permite buscar preços de combustíveis filtrando por região e produto.
- Parâmetros:
- `region`: Região do combustível.
- `product`: Tipo de combustível.