Yaak é um cliente de API desktop, open source e local-first para testar e construir APIs. Ele suporta REST, GraphQL, gRPC, WebSocket e Server-Sent Events. Criado por Gregory Schier, o desenvolvedor original do Insomnia, o Yaak segue uma proposta simples: suas requisições ficam na sua máquina, em arquivos de texto simples, sem conta obrigatória e sem dependência de nuvem.
Se você pesquisou por “Yaak” e encontrou mapas da zona rural de Montana, este não é esse Yaak. Yaak, Montana, é uma comunidade não incorporada perto da fronteira canadense. Este artigo é sobre o cliente de API Yaak, disponível em yaak.app.
Neste guia, você verá como o Yaak funciona na prática: onde ele armazena dados, quais protocolos suporta, como encaixá-lo em fluxos com Git e CI, e quando faz sentido usar uma plataforma design-first como o Apidog ao lado dele.
A origem do Yaak: criado pelo desenvolvedor original do Insomnia
A origem do Yaak ajuda a entender suas decisões de design.
Gregory Schier criou o Insomnia original, um dos clientes de API mais populares da década de 2010. Depois, o Insomnia foi adquirido pela Kong e evoluiu para um modelo mais amplo, com conta obrigatória e foco maior em plataforma. Parte da comunidade antiga não gostou dessa direção.
O Yaak é a nova tentativa independente de Schier: um cliente de API rápido, privado e local-first. O projeto é open source sob a licença MIT e é desenvolvido sem a pressão de um modelo de crescimento baseado em capital de risco.
Na prática, isso aparece em três escolhas:
- dados locais por padrão;
- arquivos de texto simples compatíveis com Git;
- foco em cliente de API, não em plataforma completa.
Como o Yaak armazena seu trabalho
A principal característica do Yaak é que seus dados ficam no seu sistema de arquivos.
Isso significa:
- sem login obrigatório;
- sem sincronização forçada em nuvem;
- sem telemetria;
- funcionamento offline;
- controle direto sobre requisições, ambientes e workspaces.
Esse modelo é chamado de local-first. Você consegue abrir o app, criar requisições e testar APIs sem depender de uma conta ou de um servidor externo.
Versionando requisições com Git
O Yaak armazena coleções como arquivos de texto simples. Isso permite tratar requisições de API como parte do código do projeto.
Um fluxo prático seria:
git checkout -b add-payment-api-requests
Depois:
- crie ou edite requisições no Yaak;
- salve os arquivos no repositório;
- revise as alterações com
git diff; - faça commit junto com o código da feature.
Exemplo:
git status
git diff
git add .
git commit -m "Add payment API requests"
git push origin add-payment-api-requests
Esse modelo é útil para equipes que já usam pull requests para revisar mudanças. As requisições ficam versionadas junto com o código que consome a API.
Se quiser comparar esse modelo com outras ferramentas semelhantes, veja a visão geral de clientes de API nativos de Git.
Protocolos suportados pelo Yaak
O Yaak não se limita a REST. Ele cobre protocolos comuns em backends modernos.
| Protocolo | Uso principal |
|---|---|
| REST / HTTP | Criar requisições, configurar headers, bodies e analisar respostas |
| GraphQL | Escrever queries com suporte a schema |
| gRPC | Chamar serviços gRPC diretamente |
| WebSocket | Testar comunicação bidirecional em tempo real |
| Server-Sent Events | Consumir eventos enviados pelo servidor via HTTP |
Exemplo: teste básico de REST
Um fluxo típico no Yaak:
- crie uma nova requisição HTTP;
- selecione o método, por exemplo
GET; - informe a URL da API;
- adicione headers, se necessário;
- envie a requisição;
- valide status, body e headers da resposta.
Exemplo de endpoint:
GET https://api.example.com/users
Authorization: Bearer <token>
Accept: application/json
Exemplo: payload JSON em uma requisição POST
POST https://api.example.com/users
Content-Type: application/json
Authorization: Bearer <token>
{
"name": "Ana",
"email": "ana@example.com"
}
Autenticação
O Yaak também cobre esquemas comuns usados em APIs reais, incluindo:
- OAuth 2.0;
- AWS Signature v4;
- JWT;
- autenticação personalizada.
Além disso, ele importa dados de:
- Postman;
- Insomnia;
- OpenAPI;
- Swagger;
- curl.
Isso facilita migrar coleções existentes sem recomeçar do zero.
Essa combinação coloca o Yaak na mesma categoria de clientes de API REST completos, com o diferencial de funcionar offline por padrão.
Usando a CLI do Yaak em automação
Para muitos times, uma interface gráfica não é suficiente. O Yaak também oferece uma CLI complementar para executar requisições salvas fora do app desktop.
Isso é útil em dois cenários principais.
1. CI/CD
Você pode executar requisições em pipelines sem abrir a interface gráfica.
Um fluxo comum seria:
# exemplo conceitual
yaak run <request-or-collection>
Esse padrão permite usar requisições salvas como verificações automáticas em CI.
Por exemplo:
- desenvolvedor altera uma API;
- abre um pull request;
- pipeline executa as requisições salvas;
- falhas aparecem antes do merge.
2. Agentes de IA e automação local
A CLI também é o caminho recomendado para fluxos com agentes. Em vez de depender da interface desktop, um agente pode acionar requisições salvas programaticamente.
O Yaak chegou a oferecer um plugin experimental de servidor MCP, Model Context Protocol, para assistentes como Claude e Cursor inspecionarem e enviarem requisições. Esse plugin foi descontinuado. Hoje, o caminho recomendado pelo Yaak para fluxos orientados por agentes é a CLI.
A conclusão prática: as requisições que você cria no app podem ser reaproveitadas em scripts, pipelines e automações.
Preços e licenciamento
O Yaak separa uso pessoal e uso comercial.
O código-fonte é licenciado sob MIT. Você pode visualizar, modificar, construir e executar o código por conta própria. Os termos comerciais se aplicam aos binários pré-construídos, não ao código-fonte em si.
Resumo:
- uso pessoal: gratuito;
- uso comercial: requer licença paga;
- teste inicial: 30 dias no primeiro lançamento, sem cartão de crédito;
- times: planos pagos por assento.
Como preços mudam, consulte yaak.app/pricing antes de adotar em ambiente profissional.
Quando usar o Yaak
O Yaak faz sentido se você quer um cliente de API com estas características:
- desktop;
- rápido;
- offline;
- sem conta obrigatória;
- sem sincronização forçada;
- com arquivos versionáveis em Git;
- focado em testar APIs diretamente.
Ele é uma boa escolha para desenvolvedores que preferem manter requisições locais e controlar exatamente quando e como esses dados são compartilhados.
Também vale considerá-lo se você está avaliando alternativas ao Postman ou clientes de API offline.
O Yaak também é uma comparação natural com ferramentas como Insomnia e Bruno. Veja também:
Onde o Apidog se encaixa ao lado do Yaak
O Yaak é um cliente local-first e nativo de Git. Essa é sua força. Ele não tenta ser uma plataforma completa de ciclo de vida de API.
Se seu fluxo envolve apenas criar requisições, testar endpoints e manter tudo local, o Yaak pode ser suficiente.
Mas se sua equipe precisa centralizar design, testes, mocking, documentação e colaboração, o problema muda. Nesse caso, uma plataforma design-first pode fazer mais sentido.
O Apidog é uma plataforma de API focada na camada de contrato. Ele permite:
- projetar APIs em um editor visual OpenAPI;
- trabalhar com branches;
- executar cenários de teste automatizados;
- usar asserções visuais;
- gerar servidores de mock dinâmicos sem código;
- publicar documentação interativa;
- colaborar em workspaces compartilhados;
- executar cenários salvos em CI com a CLI do Apidog.
O Apidog funciona como aplicativo desktop para Windows, Mac e Linux, além de aplicativo web. Ele suporta REST, GraphQL, gRPC, WebSocket, SOAP e Socket.IO.
A escolha prática é:
- use Yaak quando você quer um cliente offline, rápido e baseado em arquivos;
- use Apidog quando design-first, mocks, documentação, testes e colaboração precisam estar no mesmo fluxo.
As duas abordagens podem coexistir no mesmo time.
FAQ
O Yaak é gratuito?
Sim, para uso pessoal. O Yaak é gratuito para uso pessoal, e o código-fonte é open source sob a licença MIT. Para uso comercial no trabalho, é necessária uma licença paga. Consulte yaak.app/pricing para preços atuais.
O Yaak é open source?
Sim. O Yaak é open source sob a licença MIT. Você pode visualizar, modificar, construir e executar o código-fonte por conta própria. Os termos comerciais se aplicam aos binários pré-construídos, não ao código-fonte.
Quem criou o Yaak?
Gregory Schier criou o Yaak. Ele também foi o desenvolvedor original do Insomnia antes da aquisição pela Kong.
Quais protocolos o Yaak suporta?
O Yaak suporta REST/HTTP, GraphQL, gRPC, WebSocket e Server-Sent Events. Ele também oferece suporte a autenticação comum, como OAuth 2.0, AWS Signature v4 e JWT, além de importar dados de Postman, Insomnia, OpenAPI, Swagger e curl.
O Yaak funciona offline?
Sim. O Yaak é local-first e funciona offline. Suas requisições ficam no sistema de arquivos, sem conta obrigatória e sem telemetria. Para mais opções, veja a lista de clientes de API gratuitos.
O Yaak está relacionado a Yaak, Montana?
Não. Yaak, Montana, é um lugar perto da fronteira canadense. O cliente de API Yaak é um software disponível em yaak.app. Eles apenas compartilham o mesmo nome.
Top comments (0)