Skip to main content

RPC Styles: gRPC, JSON-RPC, and When to Prefer Them

This generated surface maps a learner-facing curriculum unit to its canonical source routes.

Curriculum surface

  • Open learner-facing unit
  • Curriculum path: content/curriculum/architecture/semester-07-architecture-ddd/module-04-api-design-contract-evolution/concepts/cluster-04-rpc-graphql-event-driven/10-rpc-styles-grpc-json-rpc-when-to-prefer-primary.md
  • App: architecture
  • Semester: semester-07-architecture-ddd
  • Module: module-04-api-design-contract-evolution
  • Unit kind: concept
  • Curation level: module_curated

Learning objectives

  • Explain RPC Styles: gRPC, JSON-RPC, and When to Prefer Them as a contract and evolution problem, not just an endpoint-shape or schema-format decision.
  • Use RPC Styles: gRPC, JSON-RPC, and When to Prefer Them to reason about compatibility, versioning, lifecycle cost, and the blast radius of public interfaces.
  • Use api-design-patterns, fundamentals-of-software-architecture to connect the learner page to contract design, compatibility strategy, and API governance decisions.

Prerequisites

  • Comfort with modular boundaries and bounded contexts, because APIs are where those boundaries become explicit contracts.

Source books

  • api-design-patterns
  • fundamentals-of-software-architecture

Source routes

Api Design Patterns

  • /books/api-design-patterns via Geewax: What are resource-oriented APIs?, Geewax: What are web APIs? (contrasts RPC and resource-oriented)

Fundamentals Of Software Architecture

Supporting curriculum routes

No supporting curriculum routes linked yet.

External enrichment

  • Microsoft REST API Guidelines (official_docs_companion) - Anchors API contract thinking in a real, widely used design standard rather than intuition.
  • Zalando RESTful API Guidelines (optional_deep_dive) - Useful for comparing how different organizations encode compatibility and lifecycle tradeoffs.

AI companion modes

  • Explain simply
  • Socratic tutor
  • Challenge my understanding
  • Diagnose my confusion
  • Connect forward / backward

Source-of-truth note

This teaching unit is learner-facing guidance assembled from multiple canonical book routes. Use the listed source books as the primary conceptual spine for RPC Styles: gRPC, JSON-RPC, and When to Prefer Them, and treat outside material as supporting enrichment only.