Search and discover APIs by what you want to accomplish. Find API providers, individual APIs, and schemas across the APIs.io network.

curl-runner 2.5.0 imports OpenAPI and Swagger specs in the CLI and the studio. What you get, how secrets stay out of your files and what is skipped.

Turn your OpenAPI definition into a running Spring Boot server in minutes with Swagger Codegen: generate the stub, run it, and see your API live in Swagger UI.

# Testifly 2.0: Como Automatizar Testes de API sem Escrever um Prompt ## Introdução Você já perdeu horas escrevendo casos de teste para cada endpoint da sua API? Com o **Testifly** isso acabou. Em poucos minutos a ferramenta gera, executa e mantém testes de integração a partir da sua especificação OpenAPI – tudo sem que você precise digitar um único prompt. Neste artigo você vai descobrir, passo a passo, como integrar o Testifly ao seu pipeline CI/CD (GitHub Actions ou GitLab CI), gerar testes reais em código JavaScript/TypeScript, controlar a flakiness e medir o ROI da estratégia de _testing autónomo_. > **Aviso:** Este guia assume que você já tem uma API REST documentada com OpenAPI 3.0 e um repositório Git hospedado no GitHub ou GitLab. ## 1. O que é testing autónomo (zero‑prompt)? Testing autónomo = IA que **analisa** seu código, suas especificações (OpenAPI, GraphQL, Swagger) e **gera** testes automaticamente. Diferente dos testes manuais, onde cada caso é escrito por um QA, o zero‑prompt: Característica | Testes Tradicionais | Testing Autónomo ---|---|--- Criação | Manual, linha a linha | Automática, a partir da especificação Manutenção | Propensa a dívida técnica | Atualiza‑se quando a API muda Cobertura | Limitada ao esforço da equipe | Busca cobertura total (códigos de status, schemas, limites) Velocidade | Demora semanas | Minutos ## 2. Preparando o ambiente ### 2.1. Pré‑requisitos # Node 18+ ou Python 3.9+ # Docker (opcional, para execução on‑premise) # Conta no Testifly (obtenha a API‑KEY no dashboard) ### 2.2. Instalação da CLI do Testifly npm i -g @testifly/cli # ou pip install testifly-cli Verifique a instalação: testifly --version ## 3. Gerando testes a partir de um OpenAPI spec ### 3.1. Arquivo `openapi.yaml` openapi: 3.0.3 info: title: API de Pedidos version: 1.0.0 paths: /orders: get: summary: Lista pedidos responses: '200': description: Lista de pedidos content: application/json: schema: type: array items: $ref: '#/components/schemas/Order' components: schemas: Order: type: object properties: id: type: integer amount: type: number ### 3.2. Comando para gerar testes (JavaScript) testifly generate \ --spec ./openapi.yaml \ --lang javascript \ --framework jest \ --output ./tests/generated O comando acima cria arquivos como `orders.test.js` contendo: import request from 'supertest'; import app from '../src/app'; describe('GET /orders', () => { it('deve retornar 200 e lista de pedidos', async () => { const response = await request(app).get('/orders'); expect(response.status).toBe(200); expect(Array.isArray(response.body)).toBe(true); // validação automática do schema response.body.forEach(order => { expect(order).toMatchObject({ id: expect.any(Number), amount: expect.any(Number), }); }); }); }); > **Dica:** Use a flag `--target node` para gerar testes que rodam direto no ambiente de CI sem precisar de `supertest`. ## 4. Integrando ao CI/CD ### 4.1. GitHub Actions Crie o arquivo `.github/workflows/testifly.yml`: name: Testifly – Testes Autônomos on: push: branches: [ main ] pull_request: jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Setup Node uses: actions/setup-node@v3 with: node-version: '20' - name: Instalar dependências run: npm ci - name: Instalar CLI Testifly run: npm i -g @testifly/cli - name: Gerar testes env: TESTIFLY_API_KEY: ${{ secrets.TESTIFLY_API_KEY }} run: | testifly generate --spec ./openapi.yaml \ --lang javascript --framework jest \ --output ./tests/generated - name: Executar testes run: npm test ### 4.2. GitLab CI stages: - test testifly: stage: test image: node:20 script: - npm ci - npm i -g @testifly/cli - testifly generate --spec ./openapi.yaml --lang javascript --framework jest --output ./tests/generated - npm test only: - main ## 5. Lidando com flakiness (testes intermitentes) 1. **Retry automático** – Adicione ao `jest.config.js`: module.exports = { testRetryTimes: 2, // tenta novamente duas vezes antes de falhar }; 1. **Isolamento de dados** – Use fixtures geradas pelo Testifly: testifly fixtures create --spec ./openapi.yaml --name order_fixture const { order_fixture } = require('../fixtures/order_fixture'); // use o fixture como base para o payload 1. **Relatórios de flakiness** – No dashboard do Testifly habilite _Flaky Test Detection_ ; ele marca testes que falham > 20 % das execuções e sugere ajustes. ## 6. Avaliando custos vs. ROI Métrica | Antes do Testifly | Depois do Testifly ---|---|--- Horas‑homem mensais em QA | 160 h | 45 h (manutenção) Tempo médio de release | 10 dias | 4 dias Bugs críticos em produção | 12/mes | 3/mes Custo da licença (mensal) | — | US$ 199 **Cálculo rápido de ROI (6 meses):** Economia de horas = (160 - 45) * 6 * $50/h = $34.500 Redução de bugs = 9 bugs * $2.500 = $22.500 Custo da licença = 6 * $199 = $1.194 ROI = ($34.500 + $22.500 - $1.194) / $1.194 ≈ 46× Em menos de seis meses a empresa recupera o investimento e ainda reduz drasticamente a dívida técnica. ## 7. Perguntas frequentes (FAQ) Pergunta | Resposta ---|--- **Preciso subir minha API em produção para gerar testes?** | Não. O Testifly pode rodar contra ambientes de staging ou usar mocks gerados a partir do schema. **Posso usar a ferramenta on‑premise?** | Sim. Baixe a imagem Docker `testifly/server:latest` e configure a variável `TESTIFLY_MODE=onprem`. **Como garantir a privacidade dos meus dados?** | Todas as chamadas à API do Testifly são criptografadas (TLS 1.3). Dados sensíveis são mascarados automaticamente; você pode definir regras de anonimização no dashboard. **O que acontece se a especificação OpenAPI mudar?** | Basta re‑executar o comando `testifly generate`. A CLI detecta alterações, atualiza ou remove testes obsoletos e cria novos casos. **Qual a curva de aprendizado?** | A maioria dos times começa a gerar testes úteis em 1‑2 dias de experimentação. ## 8. Próximos passos 1. **Criar um repositório de exemplo** – Clone o repo oficial do Testifly (`github.com/testifly/example-api`) e siga o tutorial de _Getting Started_. 2. **Adicionar cobertura de performance** – Use a flag `--perf` para gerar testes de carga baseados nos limites definidos no OpenAPI. 3. **Explorar a integração com Grafana** – Visualize métricas de flakiness e tempo de execução diretamente nos dashboards de observabilidade. ## Conclusão O Testifly coloca a automação de testes ao alcance de qualquer equipe de desenvolvimento, eliminando a necessidade de escrever prompts ou scripts manuais. Ao integrar a geração automática de testes ao seu pipeline _Herramienta mencionada: GitHub Copilot_

I caught up with Pedro J. Molina this week. Pedro is one of those people I always learn something from, and we tend to go a couple of years between conversat...