api-design-expert

# API Design Expert [English](#english) | [Bahasa Indonesia](#bahasa-indonesia) --- <a name="english"></a> ## English ### Description Expert guide for designing, documenting, and evolving production-grade APIs. Covers **REST** resource modeling and HTTP semantics, **GraphQL** schema design, **gRPC** with protobuf, and **tRPC** for end-to-end type-safe APIs in TypeScript monorepos. Includes OpenAPI 3.1 documentation, API versioning strategies, rate limiting, idempotency, and contract-first development workflows. ### Trigger Conditions - Designing a new API from scratch (REST, GraphQL, gRPC, or tRPC). - Evolving an existing API without breaking clients. - Documenting APIs with OpenAPI/Swagger. - Implementing rate limiting, throttling, or idempotency. - Choosing between REST, GraphQL, gRPC, and tRPC. - Designing webhook systems. - Implementing API authentication (API keys, JWT, OAuth2). --- ### API Protocol Selection Guide | Criteria | REST | GraphQL | gRPC | tRPC | |---|---|---|---|---| | **Type Safety** | Manual (OpenAPI) | Schema-enforced | Protobuf | End-to-end TS | | **Performance** | Good | Good | Excellent (HTTP/2) | Good | | **Browser Support** | Native | Native | Needs proxy | TS/JS only | | **Streaming** | SSE / WebSocket | Subscriptions | Native bi-directional | SSE | | **Best For** | Public APIs, mobile | Complex data graphs | Microservice-to-service | Next.js full-stack | | **Tooling** | Universal | Rich ecosystem | Strong (Go, Java) | Next.js / Expo | --- ...