<aside> 🔌

Буллеты про API design: REST, gRPC, GraphQL, WebSocket, контракты, документация, DX, gateway и edge.

</aside>

REST и HTTP API

• Designed and shipped X REST endpoints serving Xk RPS at Xms p95 across X client applications.
• Built a public API consumed by X external partners, backed by an OpenAPI contract and X-day deprecation policy.
• Cut endpoint p99 latency from Xms to Xms by removing X redundant downstream calls per request.
• Standardised error responses (RFC 7807) across X services, cutting client-side error-handling code X%.
• Implemented cursor-based pagination on X collection endpoints, making deep pagination constant-time.
• Added conditional requests with ETags on X endpoints, cutting response bandwidth X%.
• Introduced request validation with declarative rules across X endpoints, rejecting X% malformed input at the edge.
• Built API versioning with parallel v1/v2 support, migrating X clients over X months with zero breaking changes.
• Implemented per-tenant rate limiting at Xk req/min, cutting abuse-driven incidents from X/month to zero.
• Designed idempotent POST semantics with idempotency keys, eliminating duplicate submissions across X payment endpoints.
• Added field-level filtering and sparse fieldsets, cutting average payload size from X KB to X KB.
• Introduced bulk endpoints replacing X sequential client calls, cutting mobile screen load time from Xs to Xms.
• Built long-running operation endpoints with status polling, removing X timeout failures per day on slow jobs.
• Implemented HTTP caching semantics and compression, reducing egress cost $X/month.
• Enforced request timeouts and context propagation across X handlers, capping worst-case response time at Xs.

gRPC и внутренние протоколы

• Migrated X internal service calls from REST to gRPC, cutting p99 latency Xms and payload size X%.
• Defined X Protocol Buffers services as the internal contract, generating clients for X languages from one source.