API documentation
Keep OpenAPI/Redoc examples aligned with real responses; review changes with SDK releases—reduce “docs say X, prod does Y.”
Category · Server-side development
5 skills Category 11 of 20
This category focuses on outward service behavior and ops: docs that track reality, fair rate limits and backoff, WebSocket lifecycles, and idioms for Node and FastAPI. Together with identity & API and languages, data & caching it forms the backend delivery triangle.
In the hub it closes the “APIs & full-stack” band. The five entries match the main hub.
Keep OpenAPI/Redoc examples aligned with real responses; review changes with SDK releases—reduce “docs say X, prod does Y.”
Token/leaky bucket, per-tenant/user quotas, 429 and Retry-After—fairness so one tenant cannot starve a shared cluster.
Heartbeats, reconnect backoff, idempotent messages and ordering—session stickiness or pub/sub bridges when scaling horizontally.
Express/Fastify middleware chains, centralized errors, unhandled async rejections—watch event-loop blocking and native addon safety.
Pydantic models, dependency injection scopes, automatic OpenAPI—threading vs. sync ORMs under ASGI servers and background tasks.