Repolode
fullstorydev

fullstorydev/grpcui

Ferramenta de linha de comando que inicia uma interface no navegador para enviar solicitações interativamente a servidores gRPC, como o Postman para REST.

Alternativa open source a:Postman

Estrelas
5,936
Forks
427
Issues abertas
79
Último commit
há 5 dias

O que é?

O grpcui permite que desenvolvedores chamem métodos gRPC pelo navegador sem escrever código de cliente. Execute a ferramenta contra um servidor e ela disponibiliza uma interface com formulários, na qual você escolhe um serviço e um método, preenche os campos da solicitação, adiciona metadados e inspeciona os cabeçalhos, o corpo e os trailers da resposta.

A ferramenta descobre o esquema do serviço por meio da reflexão do servidor ou, quando ela não está disponível, a partir de arquivos-fonte .proto ou arquivos protoset compilados. O formulário da solicitação é gerado dinamicamente com base na definição da mensagem e oferece suporte a mensagens aninhadas, one-ofs, maps e tipos conhecidos, como Timestamp. Também é possível inserir solicitações como JSON bruto.

São compatíveis conexões em texto simples e TLS, inclusive TLS mútuo. Métodos de streaming também são compatíveis, mas todo o fluxo da solicitação é montado antes do envio e o fluxo completo da resposta é exibido depois; por isso, a ferramenta não oferece suporte a streaming bidirecional interativo. O projeto também inclui pacotes Go para incorporar a mesma interface a um servidor HTTP existente.

Recursos principais

  • 01Formulário web interativo gerado a partir do esquema do serviço gRPC.
  • 02Descoberta do esquema por reflexão do servidor, arquivos .proto ou arquivos protoset.
  • 03Compatibilidade com conexões em texto simples e TLS, inclusive TLS mútuo.
  • 04Compatibilidade com métodos unários e de streaming, com edição de solicitações em JSON bruto.
  • 05Exibição dos cabeçalhos da resposta, das mensagens, do status de erro e dos trailers.
  • 06Pacotes Go para incorporar a interface a outros servidores HTTP.

Casos de uso

  • Testar manualmente um serviço gRPC durante o desenvolvimento, sem escrever um cliente.
  • Explorar uma API gRPC desconhecida por meio dos métodos expostos por reflexão.
  • Depurar solicitações que exigem metadados específicos ou certificados de cliente TLS.
  • Incorporar um console de testes gRPC a uma aplicação web interna em Go.

Início rápido

  1. 1

    Instale com Homebrew (macOS ou Linux)

    brew install grpcui
  2. 2

    Ou instale a partir do código-fonte usando a ferramenta Go

    go install github.com/fullstorydev/grpcui/cmd/grpcui@latest
  3. 3

    Execute o grpcui em um servidor gRPC sem criptografia e abra no navegador a URL exibida

    grpcui -plaintext localhost:12345

Antes de usar

  • Os streams bidirecionais não são interativos: todas as mensagens de solicitação precisam ser inseridas de uma só vez, e todas as respostas são exibidas juntas.

Em coleções

Tópicos

Perguntas frequentes

O que é grpcui?
Ferramenta de linha de comando que inicia uma interface no navegador para enviar solicitações interativamente a servidores gRPC, como o Postman para REST. O grpcui permite que desenvolvedores chamem métodos gRPC pelo navegador sem escrever código de cliente. Execute a ferramenta contra um servidor e ela disponibiliza uma interface com formulários, na qual você escolhe um serviço e um método, preenche os campos da solicitação, adiciona metadados e inspeciona os cabeçalhos, o corpo e os trailers da resposta.
grpcui é gratuito? Qual é a licença?
grpcui é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
grpcui ainda é mantido?
Manutenção ativa. O último commit de grpcui foi em 2 de nov. de 2026.
Para que posso usar grpcui?
Testar manualmente um serviço gRPC durante o desenvolvimento, sem escrever um cliente. Explorar uma API gRPC desconhecida por meio dos métodos expostos por reflexão. Depurar solicitações que exigem metadados específicos ou certificados de cliente TLS. Incorporar um console de testes gRPC a uma aplicação web interna em Go.
Como instalar grpcui?
Instale com Homebrew (macOS ou Linux): brew install grpcui Ou instale a partir do código-fonte usando a ferramenta Go: go install github.com/fullstorydev/grpcui/cmd/grpcui@latest Execute o grpcui em um servidor gRPC sem criptografia e abra no navegador a URL exibida: grpcui -plaintext localhost:12345
Onde consigo grpcui?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/fullstorydev/grpcui

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados