Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é JSON-RPC?

    O JSON-RPC descreve chamadas de métodos em mensagens JSON. Na versão 2.0, a resposta repete o id da requisição e informa o resultado ou um objeto de erro.

    Também chamado de: JSON-RPC 2.0

    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

    Chamadas de métodos por mensagens

    O JSON-RPC é um protocolo de chamada de procedimento remoto: o cliente envia uma mensagem em JSON com o nome de um método para o servidor executar. Os parâmetros acompanham a chamada quando necessários. Na versão 2.0, o campo jsonrpc deve conter a string "2.0".

    Uma soma no JSON-RPC 2.0

    Neste exemplo didático, a aplicação oferece o método somar, que recebe dois números por posição:

    {
    "jsonrpc": "2.0",
    "method": "somar",
    "params": [8, 4],
    "id": 7
    }

    Se o servidor oferece esse método e executa a soma com sucesso, a resposta contém o resultado:

    {
    "jsonrpc": "2.0",
    "result": 12,
    "id": 7
    }

    A resposta contém a soma em result e repete o id recebido para associar o resultado à requisição. O método somar foi definido para este exemplo e precisa ser implementado pela aplicação que recebe a chamada.

    Erros, notificações e transporte

    Quando uma chamada falha, a resposta contém error no lugar de result. O objeto de erro informa um código e uma mensagem. Você precisa examiná-lo para distinguir uma execução bem-sucedida de uma mensagem que chegou ao servidor, mas foi recusada.

    Uma notificação omite o id e não recebe resposta, inclusive em caso de erro. A ausência de resposta, portanto, não comprova sucesso. A aplicação também escolhe como transportar as mensagens, pois o JSON-RPC não exige HTTP.

    Dúvidas frequentes

    Perguntas frequentes sobre JSON-RPC

    O JSON-RPC exige HTTP?
    O protocolo permite transportes diferentes, entre eles o HTTP. A aplicação deve definir como enviar e receber as mensagens.
    O que acontece quando o método não existe?
    No JSON-RPC 2.0, o servidor retorna error com o código -32601. Essa resposta não deve incluir result.
    Uma notificação recebe confirmação?
    O servidor não deve responder a uma notificação, que omite o id. Por isso, o cliente não recebe confirmação de sucesso nem os erros dessa execução pelo JSON-RPC.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Nas integrações desenvolvidas com agentes, você pode conferir o método enviado e comparar o id da resposta com o da requisição.

    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