🚀 Testes Automatizados de API - ServeRest com Postman e Newman

Este repositório contém uma coleção de testes automatizados para a API ServeRest, utilizando o Postman e o Newman para execução em linha de comando. O objetivo é garantir a qualidade e o funcionamento correto da API, validando respostas de sucesso e falha para diferentes endpoints.

---

🧪 Tecnologias Utilizadas

• Postman
• Newman
• Newman HTML Reporter
• Node.js
• Javascript (para validações usando pm.test())

---

📦 Instalação

1. Clone o repositório:

    git clone https://github.com/DarkMatter015/Projeto_Postman_Testes.git
    cd Projeto_Postman_Testes

2. Instale as Dependências

    npm install

Caso deseje gerar relatórios HTML, instale também o pacote do repórter:

    npm install -g newman-reporter-html

---

⚙️ Estrutura dos Testes

Os testes são organizados por tipo de requisição (GET, POST), e cada tipo de requisição possui:

• ✔️ Testes de sucesso: Verificações que validam o comportamento correto da API quando as requisições são feitas com dados válidos.
• ❌ Casos negativos: Testes que verificam o comportamento da API quando a requisição falha, como dados inválidos, falta de parâmetros obrigatórios ou autenticação inadequada.

Exemplo de testes POST:

    pm.test("SUCESSO: Produto adicionado com sucesso", () => {
    pm.response.to.have.status(201);
    const json = pm.response.json();
    pm.expect(json).to.have.property("_id");
    pm.expect(json.message).to.include("Cadastro realizado com sucesso");
    });

    // Caso negativo
    pm.test("ERRO: Nome de produto já cadastrado", () => {
        pm.response.to.have.status(400);
        const json = pm.response.json();
        pm.expect(json.message).to.include("Já existe produto com esse nome");
    });

---

▶️ Como executar os testes

✅ Sem relatório:

    npm run test

📄 Com geração de relatório HTML:

    npm run test_relatorio

O relatório será salvo na pasta results/output.html.

---

🧰 Como Usar no Postman

1. Importando a Coleção:

• Vá em File > Import no Postman.
• Selecione collections/ServeRest-Testes.postman_collection.json.

2. Importar o Ambiente:

• Vá em Environments e importe environments/serverest-env.postman_environment.json.

3. Importar Variáveis Globais:

• Vá em Globals e importe globals/workspace-globals.postman_globals.json.

4. Executar os Testes no Postman:

• Abra a coleção e clique em Run.
• Selecione o ambiente correto.
• Clique em Start Run para ver os testes em tempo real.

---

📂 Arquivos Principais

Caminho	Descrição
collections/ServeRest-Testes.postman_collection.json	Coleção com todos os testes da API
environments/serverest-env.postman_environment.json	Ambiente com variáveis para execução
globals/workspace-globals.postman_globals.json	Variáveis globais do Postman usadas nos testes
results/output.html	Relatório gerado após execução com HTML
package.json	Scripts para rodar os testes via terminal

---

👨‍💻 Autor

Lucas Matheus de Camargo

🔗 Linkedin

🐙Github

---

📝 Licença

Este projeto é livre para fins de estudo e aprendizado.