[API Design] JSON-RPC vs gRPC vs REST: RPC 패턴 비교

JSON-RPC, RPC, JSON-RPC 2.0, RPC vs REST

정의

RPC (Remote Procedure Call) = 원격 함수 호출 추상화. 세 가지 주요 형태:

1. JSON-RPC: JSON 위 RPC. 가벼움.
2. gRPC: Protobuf + HTTP/2.
3. REST (RPC 스타일): POST /api/getUser 같이 동사 endpoint.

JSON-RPC 2.0 메시지

// 요청
{
  "jsonrpc": "2.0",
  "method": "getUser",
  "params": { "id": 42 },
  "id": 1
}

// 성공 응답
{
  "jsonrpc": "2.0",
  "result": { "id": 42, "name": "koa" },
  "id": 1
}

// 에러 응답
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32601,
    "message": "Method not found"
  },
  "id": 1
}

// 알림 (응답 없음)
{
  "jsonrpc": "2.0",
  "method": "log",
  "params": ["info", "user logged in"]
}

// Batch (배열)
[
  { "jsonrpc": "2.0", "method": "a", "id": 1 },
  { "jsonrpc": "2.0", "method": "b", "id": 2 }
]

표준 에러 코드	의미
-32700	Parse error
-32600	Invalid request
-32601	Method not found
-32602	Invalid params
-32603	Internal error
-32000 ~ -32099	server error

세 가지 RPC 비교

항목	JSON-RPC	gRPC	REST (RPC 스타일)
Wire 포맷	JSON	Protobuf	JSON
전송	HTTP/WS/TCP	HTTP/2	HTTP/1.1+
Schema	옵션	필수 (proto)	OpenAPI
Streaming	없음	4 모드	SSE/WS 별도
코드 생성	옵션	자동	OpenAPI
크기 / 속도	JSON 만큼	수배 작고 빠름	JSON
브라우저	직접	grpc-web 필요	직접
Batch	기본 지원	없음	없음

JSON-RPC 의 강점

flowchart LR
    A[가벼운 spec<br/>1 페이지] --> Use1[블록체인 노드<br/>예: Ethereum]
    A --> Use2[IDE / 에디터 ↔ Language Server<br/>예: LSP]
    A --> Use3[VSCode extension API]
    A --> Use4[debugger DAP]

표준	RPC 토대
LSP (Language Server Protocol)	JSON-RPC
DAP (Debug Adapter Protocol)	JSON-RPC
MCP (Model Context Protocol)	JSON-RPC
Ethereum JSON-RPC	JSON-RPC
Bitcoin RPC	JSON-RPC

언제 어떤 RPC?

flowchart TD
    Q1{브라우저 직접 호출?}
    Q1 -->|예| Q2{내부 API?}
    Q2 -->|아니오 (외부)| REST[REST]
    Q2 -->|예| Q3{스트리밍 / typed?}
    Q3 -->|typed 강력 필요| RestOpenAPI[REST + OpenAPI]
    Q3 -->|아니오| REST
    Q1 -->|아니오 (server-to-server)| Q4{성능 critical?}
    Q4 -->|예| GRPC[gRPC]
    Q4 -->|아니오| Q5{spec 단순함 중요?}
    Q5 -->|예| JsonRpc[JSON-RPC]
    Q5 -->|아니오| GRPC

JSON-RPC 의 함정

관련 위키

• REST API Design
• gRPC
• GraphQL
• OpenAPI Swagger