Digite para filtrar os verbetes do Glossário.

    Automação e integrações · Vibe Coding: Do Zero ao MVP

    O que é gRPC?

    O gRPC permite chamar métodos de outro serviço com mensagens definidas em um contrato. O cliente envia a solicitação e trata a resposta ou o erro recebido.

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Do método declarado à chamada pela rede

    O gRPC é um sistema de chamadas de procedimento remoto: uma aplicação chama métodos implementados por outro serviço e troca mensagens com ele. A definição do serviço especifica os métodos disponíveis e os tipos de entrada e de resposta.

    No uso padrão com Protocol Buffers, essa definição fica em um arquivo .proto. A geração de código produz um cliente, também chamado de stub, que prepara as mensagens e realiza a comunicação. O servidor recebe a chamada e executa a implementação do método correspondente.

    Uma consulta de estoque

    Este exemplo didático declara um método unário, com uma mensagem de entrada e uma de resposta:

    syntax = "proto3";
    service Estoque {
    rpc Consultar (Consulta) returns (Saldo);
    }
    message Consulta {
    string sku = 1;
    }
    message Saldo {
    int32 unidades = 1;
    }

    O cliente envia o campo sku para identificar o item. A implementação de Consultar busca o estoque e devolve o campo unidades. Uma resposta com unidades: 12 informa o saldo retornado pelo servidor naquela consulta. O arquivo define a troca de mensagens, mas a lógica de consulta ao estoque precisa ser escrita no servidor.

    Prazo e falhas da chamada

    Você precisa definir quanto tempo o cliente aceita esperar pela resposta. O gRPC usa um prazo, chamado de deadline, e retorna DEADLINE_EXCEEDED ao cliente quando esse prazo é ultrapassado. Por padrão, o gRPC não define esse limite, como explica o guia de deadlines.

    O erro por prazo vencido não comprova que o servidor deixou de executar o método. O ciclo de uma chamada gRPC permite que cliente e servidor tenham conclusões diferentes sobre a mesma execução. Em métodos que alteram registros, você precisa considerar esse comportamento ao implementar novas tentativas.

    Dúvidas frequentes

    Perguntas frequentes sobre gRPC

    Cliente e servidor precisam usar a mesma linguagem?
    Eles podem usar linguagens diferentes entre as suportadas pelo gRPC. Cada lado usa código compatível com a definição do serviço e com as mensagens trocadas.
    O gRPC exige Protocol Buffers?
    O Protocol Buffers é a opção padrão para definir serviços e serializar mensagens. O gRPC também pode trabalhar com outros formatos, conforme a implementação utilizada.
    Uma chamada gRPC sempre tem uma única resposta?
    Uma chamada unária envia uma mensagem e recebe uma mensagem. O gRPC também admite fluxos de mensagens enviados pelo cliente, pelo servidor ou nos dois sentidos.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    A implementação de integrações exige compreender o contrato do serviço e tratar os erros que uma chamada remota pode retornar.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano