Building Resilient API Gateways with gRPC, REST Transcoding, and Circuit Breakers

Architecture Overview

Modern distributed architectures use lightweight, typed protocol buffer contracts between internal microservices over HTTP/2, while offering standard RESTful JSON interfaces to mobile and web clients.

API Gateway Routing Diagram

Architecture Diagram
Mermaid Flow

Circuit Breaker State Transition

<Benchmark title="gRPC vs JSON REST Ingress Throughput" description="Benchmarked with 20,000 requests/sec across 4 internal services." metrics={[ { label: "Protobuf Serialization", value: "0.18ms", change: "4.2x faster than JSON", trend: "up" }, { label: "Gateway p99 Latency", value: "4.1ms", change: "-55% latency", trend: "up" }, { label: "Circuit Breaker Tripping", value: "3 failures in 5s", change: "Automated fail-safe", trend: "neutral" } ]} />

NestJS gRPC Client Implementation

typescript
Copy
123456789101112131415161718192021@Injectable()
export class OrderGatewayService implements OnModuleInit {
  private orderService!: OrderServiceClient;

  constructor(@Inject('ORDER_PACKAGE') private readonly client: ClientGrpc) {}

  onModuleInit() {
    this.orderService = this.client.getService<OrderServiceClient>('OrderService');
  }

  async createOrder(data: CreateOrderDto) {
    return firstValueFrom(
      this.orderService.createOrder(data).pipe(
        timeout(3000),
        catchError((err) => {
          throw new ServiceUnavailableException('Order service temporarily unreachable');
        }),
      ),
    );
  }
}