DEV Community

Cover image for O que é Testfully?
Lucas
Lucas

Posted on • Originally published at apidog.com

O que é Testfully?

Se você pesquisou por uma alternativa ao Postman que também monitora APIs depois do deploy, provavelmente encontrou o Testfully. Ele aparece em listas de ferramentas de teste de API porque vai além de um cliente de requisições tradicional: combina execução manual, testes automatizados e monitoramento agendado.

Experimente o Apidog hoje

Então, o que é o Testfully e em que ponto ele entra no seu fluxo de trabalho?

Este guia explica o Testfully de forma prática: o que ele faz, como usar seus três blocos principais, como encaixar a CLI no CI/CD e quais formatos ele importa. No final, também veremos onde o Apidog se encaixa caso sua equipe precise de design, mocking e documentação de API.

O Que É o Testfully?

Testfully (testfully.io) é uma plataforma para teste, monitoramento e documentação de APIs. Ele oferece um cliente GUI para desktop e navegador, testes automatizados sem código e monitoramento de disponibilidade agendado.

Testfully

A proposta é simples: usar a mesma ferramenta para testar a API durante o desenvolvimento e continuar verificando se ela funciona depois do lançamento. Muitos clientes de API param na fase de envio de requisições. O Testfully adiciona a camada de execução recorrente e alerta.

Ele funciona em Windows, macOS, Linux e navegador. Também oferece dois modos de uso:

  • Offline: os dados ficam na sua máquina.
  • Nuvem: indicado para colaboração em equipe.

Segundo a proposta da ferramenta, ambos os modos oferecem o mesmo conjunto de recursos.

Se você quiser comparar outras opções, veja este resumo de clientes REST API.

Os Três Pilares do Testfully

O Testfully fica mais fácil de entender quando dividido em três partes:

  1. Cliente API
  2. Testes automatizados
  3. Monitoramento agendado

Cada camada reaproveita o que foi criado na anterior.

1. Cliente API

O cliente é onde você cria, organiza e envia requisições. Ele suporta:

  • REST
  • GraphQL
  • XML sobre HTTP

Na prática, você pode:

  • Criar coleções e pastas.
  • Definir ambientes como local, staging e production.
  • Usar variáveis para URLs, tokens e headers.
  • Encadear requisições.
  • Configurar autenticação, incluindo OAuth2.
  • Usar JavaScript quando precisar de lógica personalizada.

Um fluxo comum seria:

  1. Enviar uma requisição de login.
  2. Extrair o token da resposta.
  3. Salvar o token em uma variável.
  4. Usar essa variável em uma requisição protegida.

Exemplo conceitual:

POST /login
→ extrai access_token
→ salva em {{token}}

GET /me
Authorization: Bearer {{token}}
Enter fullscreen mode Exit fullscreen mode

Esse tipo de encadeamento é importante para testar fluxos reais, não apenas endpoints isolados.

Se o seu foco é trabalhar em modo offline, este guia sobre o melhor cliente API offline explica as principais compensações.

2. Testes Automatizados Sem Código

A segunda camada transforma requisições manuais em verificações repetíveis.

Em vez de enviar uma requisição e conferir a resposta manualmente, você adiciona asserções. Por exemplo:

  • Status code deve ser 200.
  • Tempo de resposta deve estar abaixo de determinado limite.
  • O corpo da resposta deve conter um campo específico.
  • Um valor retornado deve ser igual ao esperado.

Exemplo de verificações que você poderia aplicar a uma requisição de usuário:

GET /users/123

Asserções:
- status == 200
- response.body.id == 123
- response.body.email existe
Enter fullscreen mode Exit fullscreen mode

O ponto forte é que essas verificações podem ser criadas sem escrever código. Isso reduz a barreira para QA, engenheiros de produto e desenvolvedores que querem validar APIs sem manter um framework de testes separado.

Quando a lógica fica mais específica, JavaScript continua disponível como válvula de escape.

Depois de criar asserções, você pode agrupar requisições em pastas e executar a pasta inteira como uma suíte de testes. O Testfully também mantém histórico de execuções, o que ajuda a responder perguntas como:

  • Quando esse endpoint começou a falhar?
  • A falha veio depois de qual deploy?
  • Essa regressão já aconteceu antes?

Essa é a diferença entre um cliente de requisições e uma plataforma de testes: uma requisição manual prova que algo funciona agora; um teste salvo prova que continua funcionando depois.

3. Monitoramento e Alerta Agendados

O terceiro pilar é o principal diferencial do Testfully: executar testes em um cronograma e enviar alertas quando algo falha.

Você pode usar as mesmas verificações criadas para teste funcional como monitores de produção. Por exemplo:

A cada 5 minutos:
- GET /health
- GET /checkout/config
- POST /auth/login
- GET /user/profile
Enter fullscreen mode Exit fullscreen mode

Quando uma verificação falha, o Testfully pode notificar por:

  • E-mail
  • SMS
  • Slack
  • PagerDuty

A integração com PagerDuty é especialmente útil para equipes com rotação de plantão, porque uma falha em API pode acionar automaticamente a pessoa responsável.

Esse fluxo evita duplicação. Você não precisa recriar seus testes em uma ferramenta separada de observabilidade. Você define as asserções uma vez e depois as executa contra produção em um agendamento.

A CLI de Execução do Testfully para CI/CD

Testes que rodam apenas no laptop pegam menos bugs. Para levar as verificações para o pipeline, o Testfully oferece uma CLI.

Instale via npm:

npm install -g @testfully/cli
Enter fullscreen mode Exit fullscreen mode

Depois execute requisições ou pastas salvas com:

testfully run [options] -- [files]
Enter fullscreen mode Exit fullscreen mode

Você pode usar a CLI para:

  • Executar uma coleção exportada.
  • Rodar apenas uma pasta específica.
  • Selecionar um ambiente.
  • Carregar variáveis globais.
  • Gerar saída para humanos ou para o CI.

A CLI suporta dois relatores:

  • cli: saída legível no terminal.
  • junit: relatório XML compatível com ferramentas de CI.

Exemplo gerando relatório JUnit:

testfully run rick-and-morty.json \
  --reporters junit \
  --reporter-junit-export ./junit-report.xml
Enter fullscreen mode Exit fullscreen mode

Esse arquivo pode ser lido por ferramentas como GitHub Actions, GitLab CI ou Jenkins para marcar o build como aprovado ou reprovado.

Um exemplo simplificado em GitHub Actions ficaria assim:

name: API Tests

on:
  push:
    branches:
      - main

jobs:
  test-api:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 20

      - name: Install Testfully CLI
        run: npm install -g @testfully/cli

      - name: Run API tests
        run: |
          testfully run rick-and-morty.json \
            --reporters junit \
            --reporter-junit-export ./junit-report.xml
Enter fullscreen mode Exit fullscreen mode

Como a CLI é um pacote Node.js padrão, ela pode rodar em qualquer executor com Node instalado. Também pode ser usada em ambientes locais sem depender de recursos em nuvem.

Para estruturar melhor esse tipo de verificação, veja este guia de melhores práticas de CI/CD para teste de API.

Suporte de Importação: Postman e Insomnia

Migrar de ferramenta costuma ser caro quando suas coleções estão presas em um formato específico. O Testfully reduz esse atrito com suporte de importação.

Você pode importar coleções do:

  • Postman
  • Insomnia

Isso ajuda a reaproveitar:

  • Requisições existentes
  • Ambientes
  • Estrutura de pastas
  • Parte do fluxo de trabalho já definido pela equipe

Um caminho prático de migração seria:

  1. Exportar a coleção no Postman ou Insomnia.
  2. Importar o arquivo no Testfully.
  3. Revisar ambientes e variáveis.
  4. Adicionar ou ajustar asserções.
  5. Executar a coleção como suíte.
  6. Configurar agendamento para monitoramento.

Se você está avaliando uma troca, esta lista de alternativas ao Postman coloca o Testfully em contexto com outras opções.

Preços do Testfully

Os planos podem mudar, então sempre valide a página oficial antes de fechar orçamento. No momento da escrita, a estrutura informada era:

Plano Preço Para quem se encaixa
Desenvolvedor (Gratuito) $0 Um espaço de trabalho offline e um na nuvem, até 5 usuários, executor de coleção ilimitado, recursos principais e CLI
Equipe $14 por usuário/mês, cobrado anualmente Espaços de trabalho ilimitados, integração Git para espaços de trabalho offline, funções personalizadas e gerenciamento de segredos
Empresarial $29 por usuário/mês, cobrado anualmente SSO, SCIM, logs de auditoria, RBAC personalizado e relatórios de conformidade, incluindo SOC 2 Tipo 2, ISO 27001:2022 e HIPAA

O plano gratuito para Desenvolvedor inclui CLI e executor de coleções sem limite, o que pode ser suficiente para desenvolvedores individuais e pequenas equipes. Os planos pagos adicionam recursos de colaboração, governança e conformidade.

Quem Deve Usar o Testfully?

Considere o Testfully quando você precisa de uma ferramenta para:

  • Testar APIs durante o desenvolvimento.
  • Reaproveitar testes como monitores de produção.
  • Receber alertas via e-mail, SMS, Slack ou PagerDuty.
  • Criar testes sem código.
  • Usar JavaScript apenas quando necessário.
  • Trabalhar em modo offline com recursos completos.
  • Migrar coleções do Postman ou Insomnia.

Ele faz mais sentido quando monitoramento integrado é parte do requisito.

Se seu uso principal é enviar requisições ad-hoc, um cliente de API gratuito mais leve pode ser suficiente.

Onde o Apidog se Encaixa

O Testfully é forte em testes e monitoramento. Mas, se sua equipe também precisa projetar, simular e documentar APIs, vale olhar para uma plataforma com escopo mais amplo.

Apidog é uma plataforma de API tudo-em-um que cobre:

  • Design de API
  • Testes
  • Mocking
  • Documentação

No Apidog, você pode projetar contratos em um designer visual OpenAPI, gerar servidores de mock sem código, criar cenários de teste automatizados com asserções visuais e publicar documentação interativa.

Ele suporta:

Também está disponível como aplicativo desktop, aplicativo web e CLI.

Para CI/CD, o comando apidog run executa cenários e suítes de teste salvos no pipeline. Ele suporta relatores cli, html, json e junit, além de execuções orientadas por dados com -d e seleção de ambiente com -e.

Exemplo de uso:

apidog run \
  --environment production \
  --reporters cli,junit
Enter fullscreen mode Exit fullscreen mode

Você pode aprender mais no guia completo da CLI do Apidog e no tutorial sobre como testar uma REST API pela linha de comando.

A distinção principal é o escopo:

  • Testfully: foco em teste e monitoramento, com destaque para monitoramento agendado e alertas.
  • Apidog: foco no ciclo de vida completo da API, incluindo design, mock, teste e documentação.

O Apidog não oferece monitoramento de disponibilidade de produção agendado com paginação de plantão como o Testfully. A escolha depende do que sua equipe mais precisa: monitoramento contínuo ou uma plataforma design-first para construir APIs a partir do contrato.

FAQ

O Testfully é gratuito?

Sim. Existe um plano gratuito para Desenvolvedores por $0. Ele inclui um espaço de trabalho offline e um na nuvem, até 5 usuários, executor de coleções sem limite, recursos principais e CLI. Os planos pagos começam em $14 por usuário por mês, cobrados anualmente, na edição Equipe.

O Testfully possui uma CLI?

Sim. A CLI do Testfully é instalada via npm:

npm install -g @testfully/cli
Enter fullscreen mode Exit fullscreen mode

Depois você executa requisições e pastas salvas com:

testfully run
Enter fullscreen mode Exit fullscreen mode

Ela suporta relatores cli e junit, úteis para pipelines de CI/CD.

Quais protocolos o Testfully suporta?

O cliente Testfully suporta REST, GraphQL e XML sobre HTTP. Também oferece ambientes, variáveis, encadeamento de requisições, OAuth2 e scripts JavaScript para lógica personalizada.

O Testfully pode importar do Postman?

Sim. O Testfully pode importar coleções do Postman e do Insomnia. Isso permite migrar requisições, ambientes e estrutura sem reconstruir tudo manualmente.

O que torna o Testfully diferente de um cliente API normal?

O monitoramento integrado. O Testfully executa seus testes em um cronograma e envia alertas por e-mail, SMS, Slack ou PagerDuty quando uma API falha. A maioria dos clientes de requisição apenas envia chamadas manuais e não inclui uma camada de monitoramento.

O Testfully é uma boa alternativa ao Postman?

Pode ser, especialmente se você quer testar APIs e monitorar produção na mesma ferramenta. Para uma comparação mais ampla, veja esta lista das melhores alternativas ao Postman para teste de API.

Top comments (0)