DEV Community

Cover image for O Que É Kreya?
Lucas
Lucas

Posted on • Originally published at apidog.com

O Que É Kreya?

Se você trabalha com serviços gRPC, provavelmente já percebeu os limites de clientes de API genéricos. Muitas ferramentas tratam gRPC como um recurso secundário. O Kreya faz o contrário: coloca gRPC no centro do fluxo de trabalho e adiciona suporte a outros protocolos ao redor disso.

Experimente o Apidog hoje

Neste guia, você verá o que é o Kreya, onde ele funciona bem, como ele armazena projetos, como usar seus recursos de teste e quando ele faz sentido para um time de desenvolvimento.

Observação: este artigo cobre o Kreya, cliente de API feito pela riok GmbH e disponível em kreya.app. Não é a marca de moda ou beleza com o mesmo nome.

O que é o Kreya?

Kreya é um cliente de API desktop com interface gráfica, criado pela riok GmbH, uma empresa de software sediada na Suíça.

Ele permite chamar, testar e organizar APIs em vários protocolos:

  • gRPC
  • REST
  • GraphQL
  • WebSocket
  • Server-Sent Events

Na prática, você instala o aplicativo no macOS, Windows ou Linux e usa uma única interface para explorar diferentes tipos de API.

O Kreya é proprietário e segue um modelo freemium. O cliente principal pode ser usado gratuitamente, enquanto os planos pagos adicionam recursos avançados para indivíduos e equipes.

Não há versão no navegador e nenhuma conta em nuvem obrigatória para começar. O fluxo padrão é local: baixar, instalar e enviar requisições a partir da sua máquina.

Por que o Kreya é forte em gRPC

Muitos clientes de API nasceram como ferramentas REST e adicionaram gRPC depois. No Kreya, o suporte a gRPC é um recurso central.

Você pode carregar um serviço gRPC de duas formas:

  1. Importando arquivos .proto
  2. Usando gRPC Server Reflection para ler a definição do serviço a partir de um servidor em execução

Exemplo de fluxo prático:

# 1. Suba seu serviço gRPC localmente
./server

# 2. No Kreya, crie um projeto
# 3. Importe o arquivo .proto ou conecte usando server reflection
# 4. Escolha o método gRPC
# 5. Preencha a mensagem de request
# 6. Envie a chamada e inspecione a resposta
Enter fullscreen mode Exit fullscreen mode

animação mostrando o cliente Kreya em ação

O Kreya cobre os quatro tipos de chamada gRPC:

  • Unary
  • Client streaming
  • Server streaming
  • Bidirectional streaming, também chamado de duplex

Isso é importante quando você testa serviços reais que não usam apenas chamadas unárias.

Por baixo dos panos, o Kreya fala HTTP/2, transporte usado pelo gRPC. Ele também suporta HTTP/1.1 e HTTP/3.

Se você quiser se aprofundar no protocolo, veja também o guia de cliente gRPC e o passo a passo sobre como testar APIs gRPC.

Como usar o Kreya com vários protocolos

Embora o foco seja gRPC, o Kreya também funciona para outros protocolos comuns no backend moderno.

REST

Para REST, você monta requisições com:

  • Método HTTP
  • URL
  • Headers
  • Query params
  • Body
  • Autenticação

Exemplo de chamada REST comum:

POST /users HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer {{token}}

{
  "name": "Ana",
  "email": "ana@example.com"
}
Enter fullscreen mode Exit fullscreen mode

No Kreya, esse tipo de requisição pode ser salvo, versionado e reutilizado em ambientes diferentes.

Se você é novo nessa categoria, veja a visão geral sobre clientes de API REST.

GraphQL

Para GraphQL, você envia queries e mutations para um endpoint GraphQL.

Exemplo:

query GetUser($id: ID!) {
  user(id: $id) {
    id
    name
    email
  }
}
Enter fullscreen mode Exit fullscreen mode

Com variáveis:

{
  "id": "123"
}
Enter fullscreen mode Exit fullscreen mode

Se GraphQL é seu protocolo principal, veja o resumo dos melhores clientes GraphQL.

WebSocket e Server-Sent Events

Para sistemas em tempo real, o Kreya suporta:

  • WebSocket, para comunicação bidirecional
  • Server-Sent Events, para fluxo unidirecional do servidor para o cliente

Esses protocolos são úteis ao testar:

  • feeds de dados ao vivo
  • notificações
  • chats
  • eventos de backend
  • streaming de status

Se você está decidindo qual protocolo usar em um projeto, veja a comparação entre REST vs GraphQL vs gRPC.

Armazenamento offline, privacidade e Git

O Kreya se diferencia de ferramentas cloud-first em três pontos: execução offline, privacidade local e armazenamento compatível com Git.

1. Trabalhe totalmente offline

O Kreya roda na sua máquina sem depender de conexão com a internet. Projetos, ambientes e respostas permanecem locais.

Isso ajuda quando você trabalha:

  • atrás de firewall corporativo
  • com APIs internas
  • em ambientes sensíveis
  • sem permissão para sincronizar dados com nuvem de terceiros

Para comparar opções semelhantes, veja a lista de melhores clientes de API offline.

2. Mantenha os dados sob controle

Como o fluxo padrão é local, os dados das suas APIs não precisam sair da sua máquina para que você envie requisições.

Isso inclui:

  • URLs internas
  • payloads
  • tokens
  • ambientes
  • respostas
  • definições de API

O Kreya se posiciona como privacy-first. O design offline por padrão reforça essa proposta. Para ambientes bloqueados, o plano Enterprise oferece opção de licença offline que pode remover a necessidade de conta.

3. Versione projetos com Git

Um dos recursos mais úteis para equipes de engenharia é o armazenamento em arquivos JSON estruturados no disco.

Isso permite tratar projetos do Kreya como código:

git add kreya-project/
git commit -m "Add gRPC user service requests"
git push
Enter fullscreen mode Exit fullscreen mode

Com isso, você pode:

  • revisar alterações em pull requests
  • comparar mudanças com git diff
  • reverter alterações com git revert
  • manter histórico da evolução das chamadas
  • sincronizar projetos junto com o repositório da aplicação

Exemplo de fluxo em equipe:

git checkout -b add-payment-api-tests

# editar requests no Kreya

git diff
git add .
git commit -m "Add payment API requests and snapshots"
git push origin add-payment-api-tests
Enter fullscreen mode Exit fullscreen mode

Depois disso, o time revisa as mudanças como faria com qualquer código.

Esse modelo coloca o Kreya na categoria de clientes de API nativos do Git.

Testes e automação no Kreya

O Kreya não serve apenas para explorar APIs manualmente. Ele também ajuda a transformar verificações em testes repetíveis.

Testes com scripts

Você pode escrever testes scriptados em JavaScript para validar respostas.

Exemplos de verificações comuns:

// validar status
expect(response.status).to.equal(200)

// validar campo no body
expect(response.body.id).to.exist

// validar valor específico
expect(response.body.status).to.equal("active")
Enter fullscreen mode Exit fullscreen mode

Esse tipo de teste ajuda a garantir que uma API continue retornando o contrato esperado.

Testes orientados por dados

O Kreya também suporta testes data-driven, ou seja, execuções repetidas com diferentes entradas.

Exemplo de cenário:

[
  { "userId": "1", "expectedStatus": "active" },
  { "userId": "2", "expectedStatus": "inactive" },
  { "userId": "3", "expectedStatus": "blocked" }
]
Enter fullscreen mode Exit fullscreen mode

Esse modelo é útil para validar múltiplos casos sem duplicar requisições manualmente.

Testes de snapshot

Testes de snapshot capturam uma resposta de referência. Em execuções futuras, o Kreya compara a resposta atual com essa linha de base.

Use snapshots para detectar:

  • mudanças acidentais no contrato
  • campos removidos
  • tipos alterados
  • diferenças inesperadas na resposta
  • regressões em endpoints existentes

Esse recurso é especialmente útil em APIs internas consumidas por vários serviços.

Execução em CI/CD

Para pipelines, o Kreya fornece automação via CLI com relatórios no estilo JUnit.

Fluxo típico:

# exemplo conceitual de execução em pipeline
kreya test ./kreya-project --reporter junit --output reports/kreya-results.xml
Enter fullscreen mode Exit fullscreen mode

Depois, seu CI pode publicar o relatório como artefato ou exibir os resultados no painel de testes.

Isso fecha o ciclo entre:

  1. Testar localmente no desktop
  2. Versionar os testes com Git
  3. Executar no CI
  4. Bloquear regressões antes do deploy

Modelo freemium

O Kreya usa três níveis principais de preço. Os valores podem mudar, então confira a página oficial de preços do Kreya antes de decidir.

Gratuito

O plano gratuito é gratuito para sempre e cobre:

  • gRPC
  • REST
  • GraphQL
  • WebSocket
  • autenticação básica

Para exploração individual e chamadas diárias, esse plano já cobre bastante coisa.

Pro

O plano Pro é voltado para indivíduos que precisam de recursos avançados, como:

  • scripting
  • testes de snapshot
  • coleções
  • histórico de requisições
  • suporte por e-mail

Se você pretende automatizar validações, esse é o nível mais provável.

Enterprise

O plano Enterprise é voltado para empresas e adiciona:

  • suporte prioritário
  • portal do cliente
  • preço fixo para usuários ilimitados
  • opção de licença offline

Esse plano faz mais sentido para organizações com exigências rígidas de segurança, suporte ou operação offline.

Quando usar o Kreya

O Kreya é uma boa escolha se você se encaixa em um destes cenários.

Você usa muito gRPC

Se seu backend roda em gRPC, o suporte a .proto, server reflection e streaming completo torna o Kreya uma ferramenta prática para desenvolvimento e debug.

Seu time prioriza privacidade

Se seus dados de API não podem sair das máquinas dos desenvolvedores, o modelo offline e local-first resolve um problema real.

Seu time trabalha com Git

Se você quer revisar definições de API em pull requests, o armazenamento compatível com git diff se encaixa bem no fluxo de engenharia.

Você usa múltiplos protocolos

Se no mesmo dia você testa gRPC, REST e WebSocket, uma ferramenta única reduz troca de contexto.

O Kreya é menos óbvio se você precisa de um workspace hospedado no navegador, colaboração em tempo real na nuvem ou uma experiência compartilhada entre Mac, Windows e web. Ele é desktop-first por design.

Onde o Apidog se encaixa

Kreya é um cliente de API focado, local-first e forte em gRPC. Se o seu objetivo é chamar e testar APIs a partir de uma ferramenta desktop, ele faz isso bem.

Mas algumas equipes precisam de mais do que um cliente. Elas também querem:

  • projetar APIs
  • criar mocks antes do backend existir
  • gerar documentação
  • colaborar em tempo real
  • executar testes automatizados no CI/CD
  • centralizar o ciclo de vida da API

Apidog é uma plataforma de API tudo-em-um para esse escopo mais amplo.

Assim como o Kreya, ele suporta:

  • gRPC
  • REST
  • GraphQL
  • WebSocket

Além disso, também cobre SOAP e Socket.IO.

O Apidog adiciona recursos como:

  • designer visual OpenAPI
  • cenários de teste automatizados
  • CI/CD via Apidog CLI
  • mocking inteligente
  • documentação interativa gerada automaticamente
  • workspaces compartilhados para equipes
  • aplicativo desktop para Windows, Mac e Linux
  • aplicativo web
  • CLI

Comparativo de recursos entre Apidog e Kreya

A troca é direta:

  • escolha o Kreya se você quer uma ferramenta mais enxuta, desktop-first e offline por padrão
  • escolha o Apidog se você precisa cobrir design, mock, documentação, testes e colaboração no mesmo fluxo

Para comparar mais alternativas, veja o resumo de alternativas ao Postman e a lista de clientes de API incríveis.

FAQ

O Kreya é gratuito?

Sim. O Kreya possui um plano gratuito para sempre que cobre gRPC, REST, GraphQL, WebSocket e autenticação básica. Os planos pagos Pro e Enterprise adicionam scripting, testes de snapshot e recursos para equipes.

O Kreya é de código aberto?

Não. Kreya é um software proprietário feito pela riok GmbH. O plano gratuito o torna acessível, mas o código-fonte não é aberto. Se código aberto é um requisito, procure opções de clientes de API gratuitos que também sejam open source.

O Kreya funciona offline?

Sim. O Kreya é um aplicativo desktop que funciona offline. Projetos, ambientes e respostas permanecem na sua máquina. Nenhuma conta em nuvem é necessária para enviar uma requisição.

Quais protocolos o Kreya suporta?

Kreya suporta gRPC, REST, GraphQL, WebSocket e Server-Sent Events. O suporte a gRPC é o mais profundo, com importação de .proto, server reflection e todos os quatro tipos de chamada: unary, client streaming, server streaming e bidirectional streaming.

Como o Kreya lida com controle de versão?

O Kreya armazena cada projeto como arquivos JSON no disco. Você pode commitar esses arquivos no Git, revisar mudanças em pull requests e reverter alterações usando comandos Git padrão.

O cliente de API Kreya está relacionado à marca de moda Kreya?

Não. O Kreya abordado aqui é o cliente de API disponível em kreya.app, feito pela riok GmbH. Ele não tem relação com marcas de moda ou beleza que compartilham o mesmo nome.

Top comments (0)