首页
学习
活动
专区
工具
TVP
发布

接口数据返回---标准格式

开发中,如果前端和后端,在没有统一返回数据格式,我们来看一下会发生什么: 后台开发人员A,在接口返回时,习惯返回一个返回码code=0000,然后返回数据; 后台开发人员B,在接口返回时,习惯直接返回一个...所以,在项目开发中,初期搭建框架时,定好通用的接口数据返回格式,定义好全局的状态码,是非常有必要的。一个项目,甚至整个公司,遵循同一套接口返回格式规范,这样可以极大的提高进度,降低沟通成本。...接口数据返回格式: package response; import domain.ReturnCode; /** * Created by lightClouds917 * Date 2017...* 结合返回数据封装类ResponseWrapper,统一接口的数据返回格式 */ public enum ReturnCode { SUCCESS("0000","查询成功"),...("1001", "请求的接口不存在"), API_NOT_PER("1002", "没有该接口的访问权限"), PARAMS_ERROR("1004", "参数为空或格式错误"),

3.3K30

如何设计 API 接口,实现统一格式返回

文章目录: 前后端接口交互 接口返回值约定 返回值规范 正确返回 错误返回 统一定义错误码 错误码规范 Controller 层如何用?...正确返回 错误返回 详细代码实现 错误码 Controller 总结 问题思考 前后端接口交互 我们都知道,前端通常会通过后台提供的接口来获取数据来完成前端页面的渲染,前端可以为 PC 端、M 端、小程序...接口返回值约定 返回值规范 设置返回的 HTTP 响应状态码; 发生错误时,需设置 Response Body 的错误码和描述信息; 正确返回 HTTP 响应状态码,设置成 200,Response Body.../api/code/code.go Controller https://github.com/xinliangnote/go-gin-api/blob/master/internal/api/controller...问题思考 1、提供对外接口时,如何进行安全的签名验证? 2、接口的幂等性如何设计? 3、如何统一对返回数据进行敏感数据脱敏? 4、如何设计接口日志,便于接口联调时快速进行错误定位?

1.1K10
您找到你想要的搜索结果了吗?
是的
没有找到

如何设计API接口,实现统一格式返回

因为老顾这篇主要介绍的是API接口,所以我们聚焦点,其他的模块小伙伴们自行去补充。...返回格式 后端返回给前端我们一般用JSON体方式,定义如下: {#返回状态码code:integer,#返回信息描述message:string,#返回值data:object} CODE状态码 code...如接口返回用户权限异常,我们加一个状态码为101吧,下一次又要加一个数据参数异常,就加一个102的状态码。...Data 返回数据体,JSON格式,根据不同的业务又不同的JSON体。 我们要设计一个返回体类Result ?...注解 3、核心步骤就是实现接口ResponseBodyAdvice和@ControllerAdvice,判断是否需要包装返回值,如果需要,就把Controller接口返回值进行重写。

2.1K80

如何设计API接口,实现统一格式返回

因为老顾这篇主要介绍的是API接口,所以我们聚焦点,其他的模块小伙伴们自行去补充。...返回格式 后端返回给前端我们一般用JSON体方式,定义如下: { #返回状态码 code:integer, #返回信息描述 message:string, #返回值 data:object...如接口返回用户权限异常,我们加一个状态码为101吧,下一次又要加一个数据参数异常,就加一个102的状态码。...Data 返回数据体,JSON格式,根据不同的业务又不同的JSON体。 我们要设计一个返回体类Result ?...注解 3、核心步骤就是实现接口ResponseBodyAdvice和@ControllerAdvice,判断是否需要包装返回值,如果需要,就把Controller接口返回值进行重写。

57310

如何设计 API 接口,实现统一格式返回

因为这篇主要介绍的是API接口,所以我们聚焦点,其他的模块小伙伴们自行去补充。...返回格式 后端返回给前端我们一般用JSON体方式,定义如下: { #返回状态码 code:integer, #返回信息描述 message:string, #返回值 data:object...如接口返回用户权限异常,我们加一个状态码为101吧,下一次又要加一个数据参数异常,就加一个102的状态码。...Data 返回数据体,JSON格式,根据不同的业务又不同的JSON体。 我们要设计一个返回体类Result ?...注解 3、核心步骤就是实现接口ResponseBodyAdvice和@ControllerAdvice,判断是否需要包装返回值,如果需要,就把Controller接口返回值进行重写。

1.7K40

如何设计 API 接口,实现统一格式返回

因为老顾这篇主要介绍的是API接口,所以我们聚焦点,其他的模块小伙伴们自行去补充。...返回格式 后端返回给前端我们一般用JSON体方式,定义如下: { #返回状态码 code:integer, #返回信息描述 message:string, #返回值 data:object...如接口返回用户权限异常,我们加一个状态码为101吧,下一次又要加一个数据参数异常,就加一个102的状态码。...Data 返回数据体,JSON格式,根据不同的业务又不同的JSON体。 我们要设计一个返回体类Result ?...注解 3、核心步骤就是实现接口ResponseBodyAdvice和@ControllerAdvice,判断是否需要包装返回值,如果需要,就把Controller接口返回值进行重写。

38030

Spring Boot 无侵入式 实现API接口统一JSON格式返回

JSON格式 其实本没有没打算写这篇博客的,但还是要写一下写这篇博客的起因是因为,现在呆着的这家公司居然没有统一的API返回格式?...项目源代码: https://github.com/469753862/galaxy-blogs/tree/master/code/responseResult 定义JSON格式 定义返回JSON格式..., 但是我们也发现了一个问题了,想要返回统一的JSON格式需要返回Result才可以, 我明明返回Object可以了, 为什么要重复劳动, 有没有解决方法, 当然是有的啦, 下面我们开始优化我们的代码吧...Object就可以统一JSON格式了, 就不用每个返回返回Result对象了,直接让SpringMVC帮助我们进行统一的管理, 简直完美 只想看接口哦, helloError和helloMyError...是会直接抛出异常的接口,我好像没有对异常返回进行统一的处理哦 统一返回JSON格式进阶-异常处理(@ExceptionHandler)) 卧槽, 异常处理, 差点把这茬给忘了, 这个异常处理就有很多方法了

1.3K40

Spring Boot 无侵入式 实现 API 接口统一 JSON 格式返回

无侵入式 统一返回JSON格式 其实本没有没打算写这篇博客的,但还是要写一下写这篇博客的起因是因为,现在呆着的这家公司居然没有统一的API返回格式?...“项目源代码: https://github.com/469753862/galaxy-blogs/tree/master/code/responseResult 定义JSON格式 定义返回JSON格式..., 但是我们也发现了一个问题了,想要返回统一的JSON格式需要返回Result才可以, 我明明返回Object可以了, 为什么要重复劳动, 有没有解决方法, 当然是有的啦, 下面我们开始优化我们的代码吧...Object就可以统一JSON格式了, 就不用每个返回返回Result对象了,直接让SpringMVC帮助我们进行统一的管理, 简直完美 只想看接口哦, helloError和helloMyError...是会直接抛出异常的接口,我好像没有对异常返回进行统一的处理哦 统一返回JSON格式进阶-异常处理(@ExceptionHandler)) 卧槽, 异常处理, 差点把这茬给忘了, 这个异常处理就有很多方法了

1K40

前端对接口是什么意思_接口返回json格式

JSON(JavaScript Object Notation, JS 对象简谱) 是一种轻量级的数据交换格式。...它基于 ECMAScript (欧洲计算机协会制定的js规范)的一个子集,采用完全独立于编程语言的文本格式来存储和表示数据。简洁和清晰的层次结构使得 JSON 成为理想的数据交换语言。...其实如果你身边有搞前端的同学,不难发现,他们会经常说接口、报文,对于一个后端小白的我来说,也很想明白这究竟是个什么东东,最近工作一直做前后端开发,所以跟json结下了缘。...对象之间用逗号隔开了,对象里面有姓名、性别和年龄,每一个属性都是用键值对装的,并且用逗号隔开,是不是很容易呢,其实如果别人给你一大堆报文,可以用utools(一个软件),直接复制进去,就可以清楚的看到json格式了...等到去了公司做前后端分离的项目的时候,大家会发现前端与后端交互大部分都是接口(其实就是用json装的一些数据),举个栗子,用户在浏览器输入了用户名和密码要登录,这个输入的用户名和密码肯定会发到后台,后台进行一系列的处理并且给前台反馈结果

89930

Java API设计 - RESTful之统一返回格式

RESTful 是目前最流行的 API 设计规范,用于 Web 数据接口的设计。它的大原则容易把握,但是细节不容易做对。本文总结 RESTful 的设计细节,介绍如何设计出易于理解和使用的 API。...场景 API 统一返回参数 对于实际开发很重要 可规范API接口格式 便于统一调取或做封装 对于第三方调用很友好 也是最重要的一点(不会被第三方调用者评论,你这API设计的真”辣鸡“,简直没法看!)...分析 继承与HashMap,所以返回统一返回参数本身也就是一个Map,并且实现 于Serializable可反序列化。...本身即是一个Map对象,可已Json格式推送给调用者,如果想到传参,直接put即可!...代码 package com.parker.api.common.result; import com.fasterxml.jackson.annotation.JsonIgnore; import

1.7K40

开发规约:接口统一返回格式

一、前言本篇主要介绍一种常用的返回格式以及详细说明。...二、Dubbo 接口统一返回格式我们在应用中经常会涉及到 server 和 client 的交互,目前比较流行的是基于 json 格式的数据交互。...但是 json 只是消息的格式,其中的内容还需要我们自行设计。不管是 HTTP 接口还是 RPC 接口保持返回格式统一很重要,这将大大降低 client 的开发成本。...不管是 HTTP 接口 还是 RPC 接口,在处理业务逻辑时,都可以通过抛出业务异常,再由 Spring AOP 切面捕捉并封装返回值,从而达到对外接口返回格式统一的目的。...三、HTTP 接口统一返回格式3.1 定义切面处理类 package com.example.demo.web.aspect; import com.example.demo.biz.exception.BizException

52330

Django+RestFramework API接口接口文档并返回json数据操作

pip install coreapi pygments markdown # 自动化接口文档 API示例 创建django项目 django-admin startproject DjangoAPI...serializers.py,返回json数据 from rest_framework import serializers from apiApp.models import Test class...主页 点击主页提供的链接http://127.0.0.1:8000/test进入下一级目录 http://127.0.0.1:8000/docs进入接口文档 使用Postman测试工具测试api...数据 进入ubuntusoftware应用商店,搜索postman进行安装 在postman中输入http://127.0.0.1:8000/api/student点击send,并返回json数据。...以上这篇Django+RestFramework API接口接口文档并返回json数据操作就是小编分享给大家的全部内容了,希望能给大家一个参考。

1.5K20

让Laravel API永远返回JSON格式响应的方法示例

/ / json格式 JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式,易于阅读和编写,同时也易于机器解析和生成。...JSON采用与编程语言无关的文本格式,但是也使用了类C语言(包括C, C++, C#, Java, JavaScript, Perl, Python等)的习惯,这些特性使JSON成为理想的数据交换格式。...本文将给大家详细介绍关于让Laravel API永远返回JSON格式响应的方法,下面话不多说了,来一起看看详细的介绍吧 当你在编写完全为 API 服务的 Laravel 应用时,你希望所有响应都是 JSON...格式的,而不是例如说授权错误会重定向到 /home 或 /login,最终重定向会变成 InvalidArgumentException: Route [login] is not defined....下面这个简单的方案,可以让你的 Laravel 应用优先响应为 JSON 格式

2.7K10

『你的API接口安全么』之给NetCore接口返回值加密!

接口参数加密其实不是很重要(当然除了登录接口),那最重要的还是返回值内容加密: 2、整体设计思路 首先,我们还是需要定义一种加密方式,也同时需要和前端商量好,肯定是需要前端也能解密的,要不然不能页面渲染...其次,我们还是用这个接口举例子: http://localhost:9291/api/Login/GetJwtTokenSecret?...我们需要统一的对接口返回值进行加密,然后将输出到前端,所以聪明的你肯定知道如何处理,而且也要放到中间件管道外层,代码是这样,当然后期会微调,大家还是看BlogCore最新更新就行了。...Contains("application/json")) { Console.WriteLine($"非json返回格式...最后呢,就是运行下项目,就可以看到能正常的请求到接口了,而且参数也加密了: 将返回内容,进行解密,就可以看到 到这里,我们就很完美的实现了这个需求,而且不用修改之前的任意代码,只需要一个中间件,就能实现

22710

Android解析相同接口返回不同格式json数据的方法

但是封装的框架是基于后台数据格式不会改变的情况,一旦后天返回的数据产生了变化,网络解析就会发生错误。 问题产生位置 所有设计到微信和支付宝两种支付方式共存的地方。...分析 当请求接口时支付宝返回的json如下(隐私数据已隐藏): { "status": 1, "msg": "支付宝支付所需数据", "result": "**************此处时吊起支付宝的数据...根据上面两种不同的格式,清楚的发现这是两种不同的格式,一个是字符串,一个是键值对对象。这种情况在双牛掌柜网络请求框架中目前是不存在解析方式的。所以要给出一种简便可复用的解决方案。...解决方案一 接口返回不同数据这个问题很早就出现了,当时由于项目紧张,采取了一个接口根据返回数据的不同,分成了两个接口;在进行逻辑处理的时候,手动判断调用对应的接口。...将接口返回数据的泛型替换成ResponseBody就可以获取到未解析的数据了。

3.1K30
领券