用途:为Web、移动端或服务消费者设计与实现API,在REST、GraphQL、gRPC、tRPC之间按消费者、性能与类型安全需求选择模式与框架。
主要能力:提供选择框架的决策树(公开/第三方用REST+OpenAPI;同组织前端用tRPC或GraphQL;服务间用gRPC;移动端带宽受限用GraphQL)。涵盖REST框架选型:Python用FastAPI、TypeScript用Hono或tRPC、Rust用Axum、Go用Gin,并给出各自基础示例。还给出性能基准(如Axum约140k req/s、Gin约100k+、Hono约50k、FastAPI约40k),说明基准为单核JSON响应、实际随负载变化。包含游标分页(推荐,适合实时变化、大数据量)与偏移分页(仅静态小数据集);OpenAPI文档方案(FastAPI自动、Hono中间件、Axum用utoipa、Gin用swaggo);前后端集成模式(表单REST、表格分页、AI聊天SSE流式);令牌桶限流示例;GraphQL库(Strawberry、async-graphql、gqlgen、Pothos)与gRPC库(Tonic、Connect-Go、grpcio、@connectrpc/connect);并提供参考文档、脚本与各语言示例目录。
使用方式:依据Quick Decision Framework判断消费者类型,按语言选择框架,参照references与examples中的模式实现;可运行scripts/generate_openapi.py、validate_api_spec.py、benchmark_endpoints.py。
适用场景:后端API构建、前端组件连数据库、分页/限流/缓存、自动OpenAPI文档、认证授权集成、API性能与可扩展性优化。
限制:资料未提供安装命令、收费与价格、许可证、平台支持范围或具体生产效果数据,这些暂未提供。