编程技术

OpenAPI安全规范与自动扫描最佳实践

--- title: OpenAPI安全规范与自动扫描最佳实践 keywords: - OpenAPI - Swagger - 安全方案 - securitySchemes - scopes - Lint - 自动扫描 - 参数约束 - 必填校验 - 报告 description: 统一OpenAPI安全规范并实现自动扫描,校验securitySchemes...

OpenAPI模拟服务:Prism与Mockoon对比

--- title: OpenAPI模拟服务:Prism与Mockoon对比 keywords: - OpenAPI - Mock服务 - Prism - Mockoon - 契约驱动 description: 基于 OpenAPI 的模拟服务在前后端解耦与契约驱动开发中作用显著,对比两种常用工具的能力与落地。 categories: - 文章资讯 - 技术教程 --- # OpenAPI...

Page Visibility API:visibilitychange 与后台策略

--- title: "Page Visibility API:visibilitychange 与后台策略" keywords: - Page Visibility - document.hidden - visibilitychange - 后台策略 - 节能 description: "介绍页面可见性状态与事件,用于暂停动画与轮询、降低后台开销,结合生命周期与用户体验策略...

API 分页与搜索性能优化(2025)

# API 分页与搜索性能优化(2025) 高数据量下的分页与搜索需工程化优化,提升体验与稳定性。 ## 一、分页策略 - offset:简单但在大偏移下性能下降。 - cursor:基于排序键的稳定分页,适合滚动列表。 ## 二、索引与过滤 - 索引:为排序与过滤字段建立复合索引。 - 过滤:限制可组合条件与范围,避免全表扫描。 ## 三、缓存与观测 - 缓存:对热门查询与固定过滤结果进

API 多租户配额与计费治理(2025)

# API 多租户配额与计费治理(2025) 多租户的配额与计费需要技术与运营协同。 ## 一、配额与限流 - 维度:按租户/应用/密钥设定配额与限流策略。 - 动态调整:根据用量与峰值进行弹性配额调整。 ## 二、计费与结算 - 计费模型:按调用量/带宽/延迟保障等维度计费。 - 结算与发票:周期结算与发票与异常核对。 ## 三、观测与告警 - 用量观测:采集租户维度的调用与错误与时延。

API 幂等性设计与 Idempotency-Key 实战(2025)

# API 幂等性设计与 Idempotency-Key 实战(2025) 幂等性确保相同请求的重复执行结果一致,降低重试与并发带来的副作用。 ## 一、键与存储 - Idempotency-Key:客户端生成或服务端分配,服务端持久化键与结果。 - 去重窗口:设置键的有效期与状态,避免无限膨胀。 ## 二、事务与一致性 - 事务围栏:在关键写入前检查键状态并围栏保护。 - 输出缓存:对成功

API 网关与流量治理实践(2025)

# API 网关与流量治理实践(2025) API 网关是进入系统的统一入口,承担认证、路由与流量治理职责。 ## 一、路由与策略 - 路由编排:基于路径/方法/租户进行精准路由与转发。 - 策略执行:在网关层进行统一的认证与授权策略。 ## 二、流量治理 - 速率限制:按租户或客户端维度限流与配额管理。 - 熔断与重试:在依赖异常时快速熔断与退避重试。 - 灰度与分流:按比例或标签进行灰度

API 错误码规范与诊断清单(2025)

# API 错误码规范与诊断清单(2025) 统一错误码与诊断流程让跨团队协作更高效。 ## 一、结构与分类 - 结构:`code`/`message`/`traceId`/`details`。 - 分类:客户端/服务端/依赖错误细分与范围编码。 ## 二、诊断与重试 - 诊断清单:必采集字段与上下文、用户影响与复现路径。 - 重试与退避:按错误类别设定可重试策略。 ## 三、观测与告警