福田哪家建设网站好百度一下官网网址

当前位置： 首页 > news >正文

福田哪家建设网站好,百度一下官网网址,淘宝网站建设规划书,北京网站制作飞沐【强制】前后端交互的 API#xff0c;需要明确协议、域名、路径、请求方法、请求内容、状态码、响 应体。 说明#xff1a; 协议#xff1a;生产环境必须使用 HTTPS。路径#xff1a;每一个 API 需对应一个路径#xff0c;表示 API 具体的请求地址#xff1a; a#xff… 【强制】前后端交互的 API需要明确协议、域名、路径、请求方法、请求内容、状态码、响 应体。 说明 协议生产环境必须使用 HTTPS。路径每一个 API 需对应一个路径表示 API 具体的请求地址 a 代表一种资源只能为名词推荐使用复数不能为动词请求方法已经表达动作意义。 b URL 路径不能使用大写单词如果需要分隔统一使用下划线。 c 路径禁止携带表示请求内容类型的后缀比如.json,“.xml”通过 accept 头表达即可。请求方法对具体操作的定义常见的请求方法如下 a GET从服务器取出资源。 b POST在服务器新建一个资源。 c PUT在服务器更新资源。 d DELETE从服务器删除资源。 4 请求内容URL 带的参数必须无敏感信息或符合安全要求body 里带参数时必须设置 Content-Type。响应体响应体 body 可放置多种数据类型由 Content-Type 头来确定。 【强制】前后端数据列表相关的接口返回如果为空则返回空数组[]或空集合{}。 说明此条约定有利于数据层面上的协作更加高效减少前端很多琐碎的 null 判断。 【强制】服务端发生错误时返回给前端的响应信息必须包含 HTTP 状态码errorCode、errorMessage、用户提示信息四个部分。 说明四个部分的涉众对象分别是浏览器、前端开发、错误排查人员、用户。其中输出给用户的提示信息要求简短清晰、提示友好引导用户进行下一步操作或解释错误原因提示信息可以包括错误原因、上下文环境、推荐操作等。 errorMessage简要描述后端出错原因便于错误排查人员快速定位问题注意不要包含敏感数据信息。 正例常见的 HTTP 状态码如下 1 200 OK: 表明该请求被成功地完成所请求的资源发送到客户端。 2 401 Unauthorized: 请求要求身份验证常见对于需要登录而用户未登录的情况。 3 403 Forbidden服务器拒绝请求常见于机密信息或复制其它登录用户链接访问服务器的情况。 4 404 Not Found: 服务器无法取得所请求的网页请求资源不存在。 5 500 Internal Server Error: 服务器内部错误。 【强制】在前后端交互的 JSON 格式数据中所有的 key 必须为小写字母开始的lowerCamelCase 风格符合英文表达习惯且表意完整。 正例errorCode / errorMessage / assetStatus / menuList / orderList / configFlag 反例ERRORCODE / ERROR_CODE / error_message / error-message / errormessage / ErrorMessage / msg 【强制】errorMessage 是前后端错误追踪机制的体现可以在前端输出到 type“hidden” 文字类控件中或者用户端的日志中帮助我们快速地定位出问题。 【强制】对于需要使用超大整数的场景服务端一律使用 String 字符串类型返回禁止使用 Long 类型。 说明Java 服务端如果直接返回 Long 整型数据给前端JS 会自动转换为 Number 类型注此类型为双精度浮点数表示原理与取值范围等同于 Java 中的 Double。Long 类型能表示的最大值是 2 的 63 次方-1在取值范围之内超过 2 的 53 次方 (9007199254740992)的数值转化为 JS 的Number 时有些数值会有精度损失。扩展说明在 Long 取值范围内任何 2 的指数次整数都是绝对不会存在精度损失的所以说精度损失是一个概率问题。若浮点数尾数位与指数位空间不限则可以精确表示任何整数但很不幸双精度浮点数的尾数位只有 52 位。 反例通常在订单号或交易号大于等于 16 位大概率会出现前后端单据不一致的情况比如“orderId”: 362909601374617692前端拿到的值却是: 362909601374617660。 【强制】HTTP 请求通过 URL 传递参数时不能超过 2048 字节。 说明不同浏览器对于 URL 的最大长度限制略有不同并且对超出最大长度的处理逻辑也有差异2048字节是取所有浏览器的最小值。 反例某业务将退货的商品 id 列表放在 URL 中作为参数传递当一次退货商品数量过多时URL 参数超长传递到后端的参数被截断导致部分商品未能正确退货。 【强制】HTTP 请求通过 body 传递内容时必须控制长度超出最大长度后后端解析会出 错。 说明nginx 默认限制是 1MBtomcat 默认限制为 2MB当确实有业务需要传较大内容时可以通过调大服务器端的限制。 【强制】在翻页场景中用户输入参数的小于 1则前端返回第一页参数给后端后端发现用 户输入的参数大于总页数直接返回最后一页。 【强制】服务器内部重定向必须使用 forward外部重定向地址必须使用 URL 统一代理模块 生成否则会因线上采用 HTTPS 协议而导致浏览器提示“不安全”并且还会带来 URL 维护 不一致的问题。 【推荐】服务器返回信息必须被标记是否可以缓存如果缓存客户端可能会重用之前的请求 结果。 说明缓存有利于减少交互次数减少交互的平均延迟。 正例http 1.1 中s-maxage 告诉服务器进行缓存时间单位为秒用法如下 response.setHeader(“Cache-Control”, “s-maxage” cacheSeconds); 【推荐】服务端返回的数据使用 JSON 格式而非 XML。 说明尽管 HTTP 支持使用不同的输出格式例如纯文本JSONCSVXMLRSS 甚至 HTML。如果我 们使用的面向用户的服务应该选择 JSON 作为通信中使用的标准数据交换格式包括请求和响应。此外 application/JSON 是一种通用的 MIME 类型具有实用、精简、易读的特点。 【推荐】前后端的时间格式统一为yyyy-MM-dd HH:mm:ss统一为 GMT。 14.【参考】在接口路径中不要加入版本号版本控制在 HTTP 头信息中体现有利于向前兼容。 说明当用户在低版本与高版本之间反复切换工作时会导致迁移复杂度升高存在数据错乱风险。
errorCode附表部分