Skip to content

接口基础约定 ​

项目约定
方法查询 GET,创建 POST,更新 PUT,删除 DELETE;以源码映射为准
参数路径参数标识资源,查询参数用于分页/过滤,请求体用于业务对象
分页使用统一页码、页大小和总数结构,最大页大小由服务限制
时间使用带时区或明确时区的 ISO-8601;服务端统一记录 UTC/业务时区约定
幂等创建订单、上传合并、异步启动等接口必须支持业务幂等键
追踪返回或透传 Trace ID,前端报错时保留该值