API Data Extraction & Analytics Pipeline

Este repositório contém um conjunto de scripts em Python projetados para interagir com uma API de mensageria, permitindo a extração de métricas, geração de relatórios analíticos e a consolidação de dados para análise de performance.

🚀 Funcionalidades

• Consolidação de Métricas: Obtém dados de desempenho.

• Gestão de Jobs: Solicita a geração de relatórios analíticos pesados através de um sistema de Jobs.

• Download Automatizado: Descarrega os resultados dos relatórios gerados e guarda-os localmente.

• Processamento de Dados: Estrutura as respostas JSON da API em arquivos CSV organizados por data e hora.

🚀 Tecnologias Utilizadas

O projeto foi desenvolvido utilizando as seguintes tecnologias:

• Linguagem de Programação: Python 3.
• Bibliotecas: Pandas, Numpy, Requests, Python-dotenv.

🛠️ Instalação

1. Clonar o repositório:

git clone https://github.com/raphaelsette/script-analytics-api-consolidator.git
cd script-analytics-api-consolidator

2. Instalar dependências:

pip install -r requirements.txt

3. Configurar Variáveis de Ambiente: Crie um arquivo .env na raiz do projeto baseado no .env.example:

BASE_ENDPOINT=https://api.exemplo.com
RESOURCES=id_1,id_2,id_3
SECRET_KEY=teu-token-aqui

⚙️ Configurações Adicionais

• Timezone: O projeto está configurado para o fuso horário America/Sao_Paulo.

• Rate-Limit: Os scripts incluem intervalos (sleep) de 3 a 5 segundos entre requisições para evitar bloqueios pela API.

📝 Como Usar

O fluxo de trabalho está dividido em três scripts principais:

1. Gerar Métricas Consolidadas

python -m scripts.gerar_consolidado

2. Solicitar Relatório Analítico (Job)

python -m scripts.solicitar_analitico

3. Download de Resultados Analíticos

python -m scripts.download_analitico