diff --git a/README.md b/README.md index 127f2a2..3e59b36 100644 --- a/README.md +++ b/README.md @@ -1,27 +1,46 @@ -# 🎯 Testes de API com Postman e Newman +
-[![GitHub Actions](https://github.com/sthefanyricardo/testes-api-postman-newman/actions/workflows/main.yml/badge.svg)](https://github.com/sthefanyricardo/testes-api-postman-newman/actions) -[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) -[![Node.js Version](https://img.shields.io/badge/node-%3E%3D14.0.0-brightgreen)](https://nodejs.org) +

🏆 Testes de API com Postman e Newman

+ + +[![Node Version](https://img.shields.io/badge/Node-%3E%3D14.0.0-339933?logo=node.js)](https://nodejs.org) +[![npm Version](https://img.shields.io/badge/npm-%3E%3D6.0.0-CB3837?logo=npm)](https://npmjs.com) [![Postman](https://img.shields.io/badge/Postman-FF6C37?logo=postman&logoColor=white)](https://www.postman.com/) +[![Newman](https://img.shields.io/badge/Newman-CLI-FF6C37?logo=postman&logoColor=white)](https://github.com/postmanlabs/newman) + + +[![GitHub Actions](https://github.com/sthefanyricardo/testes-api-postman-newman/actions/workflows/main.yml/badge.svg)](https://github.com/sthefanyricardo/testes-api-postman-newman/actions) +[![GitHub Pages](https://img.shields.io/badge/GitHub%20Pages-Live-success?logo=github)](https://sthefanyricardo.github.io/testes-api-postman-newman/) +[![Issues](https://img.shields.io/github/issues/sthefanyricardo/testes-api-postman-newman?logo=github)](https://github.com/sthefanyricardo/testes-api-postman-newman/issues) +[![Pull Requests](https://img.shields.io/github/issues-pr/sthefanyricardo/testes-api-postman-newman?logo=github)](https://github.com/sthefanyricardo/testes-api-postman-newman/pulls) + +[![Last Commit](https://img.shields.io/github/last-commit/sthefanyricardo/testes-api-postman-newman?logo=github)](https://github.com/sthefanyricardo/testes-api-postman-newman/commits/main) + + +[![GitHub stars](https://img.shields.io/github/stars/sthefanyricardo/testes-api-postman-newman?style=social)](https://github.com/sthefanyricardo/testes-api-postman-newman/stargazers) +[![GitHub forks](https://img.shields.io/github/forks/sthefanyricardo/testes-api-postman-newman?style=social)](https://github.com/sthefanyricardo/testes-api-postman-newman/network/members) +[![GitHub watchers](https://img.shields.io/github/watchers/sthefanyricardo/testes-api-postman-newman?style=social)](https://github.com/sthefanyricardo/testes-api-postman-newman/watchers) + +
--- ## 📋 Índice - [Sobre o Projeto](#-sobre-o-projeto) - [Funcionalidades](#-funcionalidades) -- [Tecnologias e Ferramentas](#-tecnologias-e-ferramentas) +- [Tecnologias e Ferramentas](#️-tecnologias-e-ferramentas) - [Estrutura do Projeto](#-estrutura-do-projeto) - [Cobertura de Testes](#-cobertura-de-testes) -- [Roadmap](#-roadmap) -- [Pipeline CI/CD](#-pipeline-cicd) +- [Roadmap](#️-roadmap) +- [Pipeline CI/CD](#️-pipeline-cicd) - [Pré-requisitos](#-pré-requisitos) - [Instalação](#-instalação) -- [Como Executar](#-como-executar) +- [Como Executar](#️-como-executar) - [Relatórios](#-relatórios) -- [Licença](#-licença) +- [Contribuindo](#-contribuindo) - [Agradecimentos](#-agradecimentos) - [Contato](#-contato) +- [Links Úteis](#-links-úteis) --- @@ -40,7 +59,7 @@ O projeto foi desenvolvido como parte do curso "[Dominando Postman: Do Teste Man - ✅ Publicar relatórios automaticamente no **GitHub Pages** - ✅ Aplicar boas práticas de QA e DevOps -### API ServeRest +### 🧠 API ServeRest Este projeto utiliza a [**ServeRest API**](https://serverest.dev/), uma API REST gratuita que simula uma loja virtual, desenvolvida por [Paulo Gonçalves](https://github.com/PauloGoncalvesBH) especificamente para servir como material de estudos em testes de API. @@ -58,10 +77,10 @@ Este projeto utiliza a [**ServeRest API**](https://serverest.dev/), uma API REST - **Testes Funcionais**: Validação de endpoints, status codes, headers e payloads - **Testes de Contrato**: Validação de JSON schema com a biblioteca Ajv -- **Testes Negativos**: Validação de cenários de erro -- **Testes de Segurança**: Validação de autenticação e autorização +- **Testes Negativos**: Validação de cenários de erro e edge cases +- **Testes de Segurança**: Validação de autenticação e autorização (Admin vs User) - **Testes de Integração**: Fluxos completos entre múltiplos endpoints -- **Testes de Performance**: Medição de tempo de resposta +- **Testes de Performance**: Medição e validação de tempo de resposta ### Recursos Técnicos @@ -70,6 +89,7 @@ Este projeto utiliza a [**ServeRest API**](https://serverest.dev/), uma API REST - 🌐 **Deploy Automático**: Publicação de relatórios no GitHub Pages - 🔍 **Variáveis de Ambiente**: Gestão de configurações por ambiente - 📝 **Documentação Viva**: Collections como documentação executável +- 🔒 **Testes de Permissão**: Validação de rotas exclusivas para administradores --- @@ -82,7 +102,6 @@ Este projeto utiliza a [**ServeRest API**](https://serverest.dev/), uma API REST | [Node.js](https://nodejs.org/) | ≥14.0.0 | Ambiente de execução e gerenciamento de dependências para Newman. | | [Newman](https://www.npmjs.com/package/newman) | Latest | Executor de linha de comando para as coleções do Postman, incluindo a geração de relatorios. | | [Postman](https://www.postman.com/) | Latest | Criação e organização das coleções de requisições, variáveis de ambiente e scripts de teste (com JavaScript). | -| [Collections no Postman](https://web.postman.co/workspace/bd80135c-7abe-4289-a106-935b4fb06bb9) | - | Coleções de requisições, variáveis de ambiente e scripts de teste (com JavaScript). | | [GitHub Actions](https://github.com/features/actions) | - | Pipelines de CI/CD | ### Reports / Relatórios @@ -92,6 +111,10 @@ Este projeto utiliza a [**ServeRest API**](https://serverest.dev/), uma API REST | [newman-reporter-html](https://www.npmjs.com/package/newman-reporter-html) | Latest | Geração de relatórios HTML padrão. | | [newman-reporter-csv](https://www.npmjs.com/package/newman-reporter-csv) | Latest | Geração de relatórios em formato CSV | +### Collections do Postman + +Acesse o workspace público com todas as coleções: [**Postman Workspace**](https://web.postman.co/workspace/bd80135c-7abe-4289-a106-935b4fb06bb9) + --- ## 📁 Estrutura do Projeto @@ -105,7 +128,7 @@ testes-api-postman-newman/ │ └── workflows/ │ └── main.yml # Configuração do pipeline CI/CD (GitHub Actions). │ └── templates/ -│ └── index.html # Configuração da página index para o deploy no GitHUb Pages +│ └── index.html # Template da página index para GitHub Pages │ ├── collections/ # Arquivos de collection.json │ ├── serve_rest_adm.postman_collection.json # Coleção de testes - Perfil Admin @@ -114,71 +137,71 @@ testes-api-postman-newman/ ├── environment/ # Arquivos .json com variáveis de ambiente (URLs). │ └── serve_rest.postman_environment.json # Variáveis de ambiente │ -└── README.md +└── README.md # Este arquivo ``` --- -## 🧪 Cobertura de Testes +## 📊 Cobertura de Testes -### Coleção API ServeRest ADM +### 👩‍💻 Coleção API ServeRest ADM | Endpoint | Métodos | Cenários | Testes | |----------|---------|----------|--------| | `/login` | POST | Login com credenciais de admin | 6 | -| `/usuarios` | GET, POST | Listagem de usuários (17 usuários), Cadastro de admin e usuário auxiliar | 10 | +| `/usuarios` | GET, POST | Listagem de usuários, Cadastro de admin e usuário auxiliar | 10 | | `/usuarios/{_id}` | GET, PUT, DELETE | Busca por ID, Edição de usuário auxiliar, Exclusão de usuário auxiliar | 13 | -| `/produtos` | GET, POST | Listagem de produtos (10 produtos), Cadastro de 2 produtos (autorizado) | 17 | +| `/produtos` | GET, POST | Listagem de produtos, Cadastro de 2 produtos (autorizado) | 17 | | `/produtos/{_id}` | GET, PUT, DELETE | Busca de 2 produtos específicos, Edição de produto (autorizado), Exclusão de produto (autorizado) | 20 | -| `/carrinhos` | GET, POST | Listagem de carrinhos ativos (2 carrinhos), Criação de carrinho com 398 unidades | 18 | +| `/carrinhos` | GET, POST | Listagem de carrinhos ativos e Criação de carrinho | 18 | | `/carrinhos/{_id}` | GET | Busca de carrinho específico com validação de cálculos | 14 | | `/carrinhos/concluir-compra` | DELETE | Tentativa de conclusão após cancelamento | 8 | | `/carrinhos/cancelar-compra` | DELETE | Cancelamento com reabastecimento de estoque | 8 | -**Total: 20 requisições | 104 testes executados | 127 assertions** +📈 **Total: 20 requisições | 104 testes executados | 127 assertions** --- -### Coleção API ServeRest User +### 👤 Coleção API ServeRest User | Endpoint | Métodos | Cenários | Testes | |----------|---------|----------|--------| | `/login` | POST | Login com credenciais de usuário comum | 6 | -| `/usuarios` | GET, POST | Listagem de usuários (17 usuários), Cadastro de user e usuário auxiliar | 10 | +| `/usuarios` | GET, POST | Listagem de usuários, Cadastro de user e usuário auxiliar | 10 | | `/usuarios/{_id}` | GET, PUT, DELETE | Busca por ID, Edição de usuário auxiliar, Exclusão de usuário auxiliar | 13 | -| `/produtos` | GET, POST | Listagem de produtos (10 produtos), **Tentativa de cadastro (403 Forbidden)** | 11 | +| `/produtos` | GET, POST | Listagem de produtos, **Tentativa de cadastro (403 Forbidden)** | 11 | | `/produtos/{_id}` | GET, PUT, DELETE | Busca de produto específico, **Tentativa de edição (403 Forbidden)**, **Tentativa de exclusão (403 Forbidden)** | 22 | -| `/carrinhos` | GET, POST | Listagem de carrinhos ativos (2 carrinhos), Criação de carrinho | 18 | +| `/carrinhos` | GET, POST | Listagem de carrinhos ativos e Criação de carrinho | 18 | | `/carrinhos/{_id}` | GET | Busca de carrinho específico com validação de cálculos | 14 | | `/carrinhos/concluir-compra` | DELETE | Tentativa de conclusão após cancelamento | 8 | | `/carrinhos/cancelar-compra` | DELETE | Cancelamento com reabastecimento de estoque | 8 | -**Total: 18 requisições | 92 testes executados | 113 assertions** +📈 **Total: 18 requisições | 92 testes executados | 113 assertions** --- -### Tipos de Validações +### 🚦 Tipos de Validações -- ✅ Status codes (200, 201, 400, 401, 404 e etc.) -- ✅ Headers (Authorization, Content-Type, Accept e etc.) -- ✅ Estrutura do corpo de resposta -- ✅ Validação de JSON Schema -- ✅ Validação de lógica de negócios -- ✅ Os dados retornados na resposta das requisições -- ✅ As mensagens de sucesso retornadas nas respostas das requisições -- ✅ As mensagens de erro retornadas nas respostas das requisições -- ✅ O tempo de resposta +- ✅ **Status codes**: 200, 201, 400, 401, 403, 404, etc. +- ✅ **Headers**: Authorization, Content-Type, Accept, etc. +- ✅ **Estrutura do corpo de resposta**: Validação de campos obrigatórios +- ✅ **Validação de JSON Schema**: Conformidade com contratos definidos +- ✅ **Validação de lógica de negócios**: Regras específicas da aplicação +- ✅ **Dados retornados**: Precisão dos valores nas respostas +- ✅ **Mensagens de sucesso**: Feedback correto em operações bem-sucedidas +- ✅ **Mensagens de erro**: Validação de mensagens em cenários de falha +- ✅ **Tempo de resposta**: Performance dos endpoints --- -### 🔑 Destaques +### 🚩 Destaques da Cobertura -**Cobertura Geral:** +**Métricas Consolidadas:** - 📊 **38 requisições totais** (20 Admin + 18 User) - ✅ **196 testes executados** (104 Admin + 92 User) - ✅ **240 assertions totais** (127 Admin + 113 User) - 🎯 **100% de taxa de sucesso** em ambas as collections -**Diferenças entre Admin e User:** +**Diferenças entre Perfis:** - ✅ **Admin**: Autorizado para POST, PUT, DELETE em `/produtos` (Status 200/201) - ❌ **User**: Bloqueado para POST, PUT, DELETE em `/produtos` (Status 403 - "Rota exclusiva para administradores") - 🔒 **6 cenários de autorização** validados com sucesso @@ -187,14 +210,14 @@ testes-api-postman-newman/ ## 🗺️ Roadmap -### Concluído +### ✅ Concluído - [x] Cobertura completa de endpoints nas Collections do Postman - [x] Múltiplos formatos de relatório com o Newman - [x] Pipeline CI/CD com GitHub Actions - [x] Deploy automático no GitHub Pages -### Em Desenvolvimento +### 🚧 Em Desenvolvimento - [ ] Desenvolvimento de testes automatizados de API com o Robot Framework - [ ] Cobertura completa dos testes cenarios positivos, negativos e alternativos com o Robot Framework @@ -204,7 +227,7 @@ testes-api-postman-newman/ - [ ] Deploy automático no GitHub Pages - [ ] Testes de contrato com Python ou Pact -### Planejado +### 📅 Planejado - [ ] Testes de carga e stress com K6 - [ ] Integração com ferramentas de monitoramento @@ -218,18 +241,17 @@ testes-api-postman-newman/ O arquivo `.github/workflows/main.yml` contém toda a configuração do pipeline. O pipeline é executado automaticamente em cada `push` ou `pull request` para a branch `main`. -#### Etapas do Pipeline +### 🔄 Etapas do Pipeline 1. **Setup**: Configuração do ambiente Node.js -2. **Install**: Instalação do Newman e reporters -3. **Test**: Execução das coleções de teste - - Coleção ADM (administrador) - - Coleção User (usuário padrão) -4. **Report**: Geração de múltiplos formatos de relatório -5. **Upload**: Armazenamento como artefatos do GitHub Actions -6. **Deploy**: Publicação automática no GitHub Pages (quando testes passam) - +2. **Install**: Instalação do Newman e reports necessários +3. **Test**: Execução sequencial das coleções de teste + - Coleção ADM (perfil administrador) + - Coleção User (perfil usuário padrão) +4. **Report**: Geração de múltiplos formatos de relatório (HTML-EXTRA, HTML, CSV, JSON) +5. **Upload**: Armazenamento como artefatos do GitHub Actions (sempre executado) +6. **Deploy**: Publicação automática no GitHub Pages (apenas quando testes passam) + ### Fluxo de Execução dos Testes - ```mermaid graph LR A[Postman Collections] --> B[Newman CLI] @@ -246,7 +268,6 @@ graph LR ``` ### Fluxo de Execução do Pipeline de CI/CD - ```mermaid graph LR A[Push/PR on branch Main] --> B[Pipeline - GitHub Actions] @@ -267,82 +288,88 @@ graph LR ### Requisitos de Sistema - **Sistema Operacional**: Windows, macOS ou Linux -- **Node.js**: v14.0.0 ou superior (Baixe e instale o Node.js em [nodejs.org](https://nodejs.org/).) -- **NPM**: v6.0.0 ou superior -- **Git**: Para clonar o repositório - -### Verificar Instalações +- **Node.js**: v14.0.0 ou superior ([Download Node.js](https://nodejs.org/)) +- **npm**: v6.0.0 ou superior (incluído com Node.js) +- **Git**: Para clonar o repositório ([Download Git](https://git-scm.com/)) +#### Verificar Instalações: ```bash +# Verificar Node.js node --version +# Verificar npm npm --version +# Verificar Git git --version ``` +#### Saídas esperadas: +``` +node v14.x.x (ou superior) +npm v6.x.x (ou superior) +git version 2.x.x (ou superior) +``` + --- ## 🔧 Instalação -### 1. Clone o Repositório +### 1️⃣ Clone o Repositório ```bash -# comando git +# Clonar via HTTPS git clone https://github.com/sthefanyricardo/testes-api-postman-newman.git -# pasta do projeto +# OU clonar via SSH +git clone git@github.com:sthefanyricardo/testes-api-postman-newman.git + +# Entrar no diretório cd testes-api-postman-newman ``` -### 2. Instale o Node.js +### 2️⃣ Instale o Node.js -Baixe e instale a versão mais recente do Node.js em [nodejs.org](https://nodejs.org/). +Baixe e instale a versão LTS mais recente do Node.js em [nodejs.org](https://nodejs.org/). Verifique a instalação: ```bash node --version - npm --version ``` -### 3. Instale o Newman e Reporters +### 3️⃣ Instale o Newman e Reports -### Instalação Global +#### Opção A: Instalação Global -**newman**: ```bash -# newman +# Instalar Newman npm install -g newman -# report newman +# Instalar Reports npm install -g newman-reporter-htmlextra - npm install -g newman-reporter-html - npm install -g newman-reporter-csv ``` -### Instalação Local +#### Opção B: Instalação Local ```bash +# Inicializar projeto npm init -y -# newman -npm install newman - -# report newman -npm install newman-reporter-htmlextra newman-reporter-html newman-reporter-csv +# Instalar Newman e Reports +npm install newman newman-reporter-htmlextra newman-reporter-html newman-reporter-csv --save-dev ``` -### 4. Verifique a Instalação +### 4️⃣ Verifique a Instalação ```bash newman --version ``` -**Saída esperada**: `newman/6.x.x` (ou versão superior) +**Saída esperada**: `newman/6.x.x` ou superior --- @@ -374,7 +401,7 @@ newman run collections/serve_rest_user.postman_collection.json \ # Criar diretório para relatórios mkdir -p newman_reports -# Executar com todos os reporters +# Executar coleção ADM com todos os reports newman run collections/serve_rest_adm.postman_collection.json \ -e environment/serve_rest.postman_environment.json \ -r cli,htmlextra,html,csv,json \ @@ -382,12 +409,21 @@ newman run collections/serve_rest_adm.postman_collection.json \ --reporter-html-export newman_reports/report-adm-html.html \ --reporter-csv-export newman_reports/report-adm.csv \ --reporter-json-export newman_reports/report-adm.json + +# Executar coleção User com todos os reports +newman run collections/serve_rest_user.postman_collection.json \ + -e environment/serve_rest.postman_environment.json \ + -r cli,htmlextra,html,csv,json \ + --reporter-htmlextra-export newman_reports/report-adm-htmlextra.html \ + --reporter-html-export newman_reports/report-adm-html.html \ + --reporter-csv-export newman_reports/report-adm.csv \ + --reporter-json-export newman_reports/report-adm.json ``` -### Executar com opções avançadas +#### Executar com opções avançadas ```bash -# Com número de iterações +# Com múltiplas iterações (executar 3 vezes) newman run collections/serve_rest_adm.postman_collection.json \ -e environment/serve_rest.postman_environment.json \ -n 3 \ @@ -399,49 +435,54 @@ newman run collections/serve_rest_user.postman_collection.json \ --delay-request 1000 \ -r cli,htmlextra -# Com timeout customizado +# Com timeout customizado (10 segundos) newman run collections/serve_rest_adm.postman_collection.json \ -e environment/serve_rest.postman_environment.json \ --timeout-request 10000 \ -r cli,htmlextra + +# Modo verbose (debug detalhado) +newman run collections/serve_rest_adm.postman_collection.json \ + -e environment/serve_rest.postman_environment.json \ + --verbose ``` --- -## Execução via GitHub Actions +### ☁️ Execução via GitHub Actions -#### Automática +#### 🤖 Execução automática Os testes são executados automaticamente em cada: -- Push para a branch `main` -- Pull Request para a branch `main` +- **Push** para a branch `main` +- **Pull Request** para a branch `main` -#### Manual +#### 🔧 Execução manual 1. Acesse a aba **Actions** no repositório do GitHub 2. Selecione o workflow **"Run the test collection of the Serve REST API with newman"** 3. Clique em **"Run workflow"** -4. Selecione a branch desejada -5. Clique em **"Run workflow"** +4. Selecione a branch desejada (padrão: `main`) +5. Clique em **"Run workflow"** novamente para confirmar --- ## 📊 Relatórios -### Tipos de Relatórios +### 📋 Tipos de Relatórios | Formato | Descrição | Uso Recomendado | |---------|-----------|-----------------| -| **HTML Extra** | Relatório detalhado e interativo | Análise visual e apresentações | -| **HTML** | Relatório padrão | Documentação e arquivamento | -| **CSV** | Dados tabulares | Análise em Excel/Google Sheets | -| **JSON** | Dados estruturados | Integração com outras ferramentas | +| **HTML Extra** | Relatório detalhado e interativo com gráficos | Análise visual completa e apresentações | +| **HTML** | Relatório padrão em HTML | Documentação e arquivamento simples | +| **CSV** | Dados tabulares exportáveis | Análise quantitativa em Excel/Sheets | +| **JSON** | Dados estruturados em formato JSON | Integração com outras ferramentas | -### Visualizar Relatórios +### 🔍 Visualizar Relatórios -### Relatórios locais +#### Relatórios Locais -Após a execução, abra os arquivos HTML no navegador: +Após a execução local, abra os arquivos HTML no navegador: ```bash # Linux/macOS @@ -451,37 +492,83 @@ open newman_reports/report-adm-htmlextra.html start newman_reports/report-adm-htmlextra.html ``` -### Relatórios do GitHub Actions +#### Relatórios do GitHub Actions -1. Acesse a aba **Actions**. -2. Selecione a execução desejada. -3. Na seção **Artifacts**, faça o download de **Reports**. -4. Extraia o arquivo ZIP e abra os relatórios HTML. -5. Ou verifique o step: deploy-github-pages que contém a url do GitHub Pages. +1. Acesse a aba **Actions** no repositório +2. Selecione a execução desejada +3. Na seção **Artifacts**, faça o download de **Reports** +4. Extraia o arquivo ZIP e abra os relatórios HTML +5. **OU** verifique o step `deploy-github-pages` que contém a URL do GitHub Pages -### GitHub Pages +#### GitHub Pages -Se os testes passarem, os relatórios são publicados automaticamente no GitHub Pages. Acesse: -- Acesse a URL nos logs da execução da Pipeline, Step: deploy-github-pages. -- Ou acesse a aba **Settings** do repositório e vá para a seção **Pages** ou **GitHub Pages**, lá você vai encontrar a URL atual do deploy no GitHub Pages. - ---- +Se os testes passarem, os relatórios são publicados automaticamente. Para acessar: + +**Opção 1**: Acesse diretamente a URL: +``` +https://sthefanyricardo.github.io/testes-api-postman-newman/ +``` -## 📄 Licença +**Opção 2**: Via GitHub +1. Acesse a aba **Settings** do repositório +2. Navegue até **Pages** na barra lateral +3. Clique na URL listada em **Your site is live at...** -Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes. +**Opção 3**: Via Logs do Pipeline +1. Acesse a aba **Actions** +2. Selecione a execução desejada +3. Veja a URL no step `deploy-github-pages` + +--- +## 🤝 Contribuindo + +Contribuições são muito bem-vindas! Para contribuir com este projeto: + +### Como Contribuir + +1. **Fork** o projeto +2. **Crie** uma branch para sua feature: + ```bash + git checkout -b feature/MinhaNovaFeature + ``` +3. **Commit** suas mudanças: + ```bash + git commit -m 'Add: nova funcionalidade X' + ``` +4. **Push** para a branch: + ```bash + git push origin feature/MinhaNovaFeature + ``` +5. **Abra** um Pull Request + +### Diretrizes + +- ✅ Siga os padrões de código existentes +- ✅ Adicione testes para novas funcionalidades +- ✅ Atualize a documentação conforme necessário +- ✅ Mantenha os commits pequenos e focados +- ✅ Descreva claramente as mudanças no PR + +### Reportar Bugs + +Encontrou um bug? Abra uma [issue](https://github.com/sthefanyricardo/testes-api-postman-newman/issues) com: +- Descrição clara do problema +- Passos para reproduzir +- Comportamento esperado vs obtido +- Versões (Node.js, Newman, SO) + --- ## 🙏 Agradecimentos Agradecimentos especiais a: -- **[Priscila Caimi](https://github.com/pricaimiTech)** - Instrutora do curso no Qualiters Club, pela excelente didática e conteúdo -- **[Paulo Gonçalves](https://github.com/PauloGoncalvesBH)** - Criador da ServeRest API, pela ferramenta educacional incrível -- **[ServeRest](https://github.com/ServeRest/ServeRest)** - Comunidade open source e documentação excelente -- **[Postman](https://www.postman.com/)** - Pela plataforma robusta de testes de API -- **[Newman Team](https://github.com/postmanlabs/newman)** - Pelo executor CLI poderoso +- **[Priscila Caimi](https://github.com/pricaimiTech)** - Instrutora do curso no Qualiters Club, pela excelente didática e conteúdo de qualidade +- **[Paulo Gonçalves](https://github.com/PauloGoncalvesBH)** - Criador da ServeRest API, pela ferramenta educacional incrível e suporte à comunidade +- **[ServeRest](https://github.com/ServeRest/ServeRest)** - Pela API open source e documentação excelente +- **[Postman](https://www.postman.com/)** - Pela plataforma robusta e completa de testes de API +- **[Newman Team](https://github.com/postmanlabs/newman)** - Pelo executor CLI poderoso e extensível --- @@ -496,31 +583,37 @@ Agradecimentos especiais a: ## 🔗 Links Úteis -### Documentação +### 📚 Documentação - [Documentação do Postman](https://learning.postman.com/docs/getting-started/introduction/) - [Documentação do Newman](https://github.com/postmanlabs/newman) - [GitHub Actions Documentation](https://docs.github.com/en/actions) - [ServeRest API Docs](https://serverest.dev) +- [Newman Reporters](https://www.npmjs.com/search?q=newman-reporter) -### Cursos +### 🎓 Cursos - [Curso na Udemy](https://www.udemy.com/course/dominando-postman-2023-testando-e-automatizado-apis) - [Curso no Qualiters Club](https://priscilacaimi.com/estude-comigo/) -### Comunidade +### 👥 Comunidade -- [Postman Community](https://community.postman.com/) -- [ServeRest GitHub](https://github.com/ServeRest/ServeRest) +- [Postman Community](https://community.postman.com/) - Fórum oficial do Postman +- [ServeRest GitHub](https://github.com/ServeRest/ServeRest) - Repositório da API +- [Postman Public Workspace](https://web.postman.co/workspace/bd80135c-7abe-4289-a106-935b4fb06bb9) - Workspace público com as coleções ---
-**⭐ Se este projeto foi útil para você, considere dar uma estrela!** +### ⭐ Se este projeto foi útil para você, considere dar uma estrela! **Desenvolvido com ❤️ por [Sthefany Ricardo](https://github.com/sthefanyricardo)** +[![Made with Postman](https://img.shields.io/badge/Made%20with-Postman-FF6C37?style=flat&logo=postman&logoColor=white)](https://www.postman.com/) +[![Powered by Newman](https://img.shields.io/badge/Powered%20by-Newman-FF6C37?style=flat&logo=postman&logoColor=white)](https://github.com/postmanlabs/newman) +[![Automated with GitHub Actions](https://img.shields.io/badge/Automated%20with-GitHub%20Actions-2088FF?style=flat&logo=github-actions&logoColor=white)](https://github.com/features/actions) + **[⬆ Voltar ao topo](#-testes-de-api-com-postman-e-newman)**