首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往
  • 您找到你想要的搜索结果了吗?
    是的
    没有找到

    如何设计API返回码(错误码)?

    —1— 前言 客户端请求API,通常需要通过返回码来判断API返回的结果是否符合预期,以及该如何处理返回的内容等。...参考HTTP状态码的思路,我们对错误码进行分段。 通过这样的设计,不论是程序还是人都可以非常方便的区分API的返回结果,关键是统一!...—4— 个性化Message 通常我们的Message都是写给工程师看的,但是在不同的场景下,同样的错误,可能需要给用户看到不一样的错误提示。...比方说20000-29999表示订单创建失败: 20001,订单创建失败,存在进行中的订单 20002,订单创建失败,上一个订单正在排队创建中 这两种错误情况如果是给用户看,可能就只适合看到:很抱歉,您有一个正在进行中的订单...但是对于API来说,返回的信息又必须是准确的,但用户看到的就必须转译,这个转译的工作调用方可以做,但是通常API提供者来提供个性化的Message能力会更好。

    83710

    如何设计API返回码(错误码)?

    一、前言 客户端请求API,通常需要通过返回码来判断API返回的结果是否符合预期,以及该如何处理返回的内容等 相信很多同学都吃过返回码定义混乱的亏,有的API用返回码是int类型,有的是string类型...分段 分段描述 1XX 信息,服务器收到请求,需要请求者继续执行操作 2XX 成功,操作被成功接收并处理 3XX 重定向,需要进一步的操作以完成请求 4XX 客户端错误,请求包含语法错误或无法完成请求...5XX 服务器错误,服务器在处理请求的过程中发生了错误 对于后端开发来说,我们通常见到的都是: 2XX状态码,比如200->请求成功, 5XX状态码,比如502->服务器异常,通常就是服务没正常运行,...API的返回结果,关键是统一!...四、个性化Message 通常我们的message都是写给工程师看的,但是在不同的场景下,同样的错误,可能需要给用户看到不一样的错误提示。

    6.5K30

    Spring Boot 中如何统一 API 接口响应格式?

    在前面的文章中(如何优雅的实现 Spring Boot 接口参数加密解密?)...,松哥已经和大家介绍过如何对请求/响应数据进行预处理/二次处理,当时我们使用了 ResponseBodyAdvice 和 RequestBodyAdvice。...3.API 接口数据包装 假设我有这样一个需求:我想在原始的返回数据外面再包裹一层,举个简单例子,本来接口是下面这样: @RestController public class UserController...: {"username":"javaboy","address":"www.javaboy.org"} 现在我希望返回的数据格式变成下面这样: {"status":"ok","data":{"username...4.小结 其实统一 API 接口响应格式办法很多,可以参考松哥之前分享的 如何优雅的实现 Spring Boot 接口参数加密解密?,也可以使用本文中的方案,甚至也可以自定义过滤器实现。

    1.3K10

    Power BI 动态格式和自定义标签如何选择

    很多时候动态格式和自定义标签是通用的,那么该如何取舍?本文总结一二。 如果是整个模型全局应用,使用动态格式。...例如所有图表都需要进行单位自动切换,参考《Power BI 动态格式的奇葩用法》 如果是在表格等不支持自定义标签的视觉对象应用,使用动态格式,《Power BI 动态格式模拟豆瓣推荐指数》在表格显示星级...: 在同时支持动态格式和自定义标签的图表中,哪个步骤少使用哪个。...例如类别标签上浮,《Power BI自定义标签用于类别标签上浮》《Power BI 动态格式用于类别标签上浮》的步骤可以比较下,自定义标签更简单。...而以下柱形图上方分别显示增长率和增长额,自定义标签需要新建额外的显示度量值,动态格式步骤更简便。《Power BI动态格式绝对值、差异额、差异率对比》讲解了制作步骤。

    34910

    9个顶级开发IoT项目的开源物联网平台

    DeviceHive开放源代码物联网平台的关键特性: 直接与Alexa整合 您选择的可视化仪表板 通过运行自定义JavaScript代码来自定义DeviceHive行为。...它提供了30多个可自定义的小部件,允许您为大多数物联网用例构建最终用户自定义仪表板。...WSo2 Build允许公开API来为移动应用提供支持,允许用户监控和控制他们的设备。您可以将其与现有的身份系统集成,或使用他们的身份系统。...边缘计算由WSO2 Siddhi提供支持。 设备通信支持的协议包括MQTT,HTTP,Websockets和XMPP协议以及用于添加更多协议和数据格式的IoT Server Framework扩展。...WSo2开源的物联网平台主要特点: 通过WSO2数据分析服务器(DAS),它支持批量,交互式,实时和预测性分析。

    17.4K10

    盘点 15 个好用的 API 接口管理神器

    但是,此API管理工具的主要功能是能够生成细粒度的报告以理解API的数据是如何使用的。 3....WSO2 API管理器 WSO2 API Manager是一个完整的生命周期API管理平台,可以随时随地运行。可以在企业内部和私有云上执行API的分发和部署。除此之外,它还提供了一些其他的便利。...而且,此APIM平台会自动生成OAI和RAML要求,并根据定义的架构创建自定义的客户端SDK。...此外,它还提供了智能错误反馈,语法自动完成和多种样式验证器可用性的机会。 10....该平台为组织提供了各种API处理功能,包括身份验证,API验证,速率限制和HTTP请求日志记录。 该API管理平台旨在提供格式正确且经过验证的信任下游请求的下游服务。

    2.7K50

    盘点 15 个好用的 API 接口管理神器

    但是,此API管理工具的主要功能是能够生成细粒度的报告以理解API的数据是如何使用的。 3....WSO2 API管理器 WSO2 API Manager是一个完整的生命周期API管理平台,可以随时随地运行。可以在企业内部和私有云上执行API的分发和部署。除此之外,它还提供了一些其他的便利。...而且,此APIM平台会自动生成OAI和RAML要求,并根据定义的架构创建自定义的客户端SDK。...此外,它还提供了智能错误反馈,语法自动完成和多种样式验证器可用性的机会。 10....该平台为组织提供了各种API处理功能,包括身份验证,API验证,速率限制和HTTP请求日志记录。 该API管理平台旨在提供格式正确且经过验证的信任下游请求的下游服务。

    3K20

    盘点 15 个好用的 API 接口管理神器

    但是,此API管理工具的主要功能是能够生成细粒度的报告以理解API的数据是如何使用的。 3....WSO2 API管理器 WSO2 API Manager是一个完整的生命周期API管理平台,可以随时随地运行。可以在企业内部和私有云上执行API的分发和部署。除此之外,它还提供了一些其他的便利。...而且,此APIM平台会自动生成OAI和RAML要求,并根据定义的架构创建自定义的客户端SDK。...此外,它还提供了智能错误反馈,语法自动完成和多种样式验证器可用性的机会。 10....该平台为组织提供了各种API处理功能,包括身份验证,API验证,速率限制和HTTP请求日志记录。 该API管理平台旨在提供格式正确且经过验证的信任下游请求的下游服务。

    2.8K50

    GSEA分析中的gmt格式文件如何自定义

    clusterProfiler包进行KEGG,GO,GSEA富集分析,有介绍在GSEA分析中,在MSigDB(Molecular Signatures Database)数据库中定义了很多基因集,下载的基因集是gmt格式文件...下载的gmt格式文件,打开后可以看见是下面这个样子的: gmt(Gene Matrix Transposed,基因矩阵转置)是多列注释文件,列与列之间都是Tab制表符分割。...官方提供的格式是URL,也可以是任意字符串。 第3列-第n列:是基因集内所有基因的名字,有几个写几列。 每一行的列数可以不一样,主要是基因集内的基因数量不一样。.../c5.go.cc.v7.2.symbols.gmt") class(gmt) 如何制作自定义的gmt文件?...collapse='\t') ) cat('\n') }) sink() } write.gmt(gs,file) gcSample数据是来自clusterProfiler包,只是用来练习,自己自定义的可能并不是这样的

    5.5K30

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

    因为老顾这篇主要介绍的是API接口,所以我们聚焦点,其他的模块小伙伴们自行去补充。...针对URL路径的restful风格,以及传入参数的公共请求头的要求(如:app_version,api_version,device等),老顾这里就不介绍了,小伙伴们可以自行去了解,也比较简单。...老顾注重介绍一下后端服务器如何实现把数据返回给前端?...Message 这个字段相对理解比较简单,就是发生错误时,如何友好的进行提示。一般的设计是和code状态码一起设计,如 ? 再在枚举中定义,状态码 ? 状态码和信息就会一一对应,比较好维护。...Data 返回数据体,JSON格式,根据不同的业务又不同的JSON体。 我们要设计一个返回体类Result ?

    60410

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

    因为这篇主要介绍的是API接口,所以我们聚焦点,其他的模块小伙伴们自行去补充。...针对URL路径的restful风格,以及传入参数的公共请求头的要求(如:app_version,api_version,device等),这里就不介绍了,小伙伴们可以自行去了解,也比较简单。...后端服务器如何实现把数据返回给前端?...Message 这个字段相对理解比较简单,就是发生错误时,如何友好的进行提示。一般的设计是和code状态码一起设计,如 ? 再在枚举中定义,状态码 ? 状态码和信息就会一一对应,比较好维护。...Data 返回数据体,JSON格式,根据不同的业务又不同的JSON体。 我们要设计一个返回体类Result ?

    1.7K40

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

    因为老顾这篇主要介绍的是API接口,所以我们聚焦点,其他的模块小伙伴们自行去补充。...针对URL路径的restful风格,以及传入参数的公共请求头的要求(如:app_version,api_version,device等),老顾这里就不介绍了,小伙伴们可以自行去了解,也比较简单。...老顾注重介绍一下后端服务器如何实现把数据返回给前端?...Message 这个字段相对理解比较简单,就是发生错误时,如何友好的进行提示。一般的设计是和code状态码一起设计,如 ? 再在枚举中定义,状态码 ? 状态码和信息就会一一对应,比较好维护。...Data 返回数据体,JSON格式,根据不同的业务又不同的JSON体。 我们要设计一个返回体类Result ?

    2.3K80

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

    因为老顾这篇主要介绍的是API接口,所以我们聚焦点,其他的模块小伙伴们自行去补充。...针对URL路径的restful风格,以及传入参数的公共请求头的要求(如:app_version,api_version,device等),老顾这里就不介绍了,小伙伴们可以自行去了解,也比较简单。...后端服务器如何实现把数据返回给前端?...Message 这个字段相对理解比较简单,就是发生错误时,如何友好的进行提示。一般的设计是和code状态码一起设计,如 ? 再在枚举中定义,状态码 ? 状态码和信息就会一一对应,比较好维护。...Data 返回数据体,JSON格式,根据不同的业务又不同的JSON体。 我们要设计一个返回体类Result ?

    42130

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

    文章目录: 前后端接口交互 接口返回值约定 返回值规范 正确返回 错误返回 统一定义错误码 错误码规范 Controller 层如何用?...第 4 位和第 5 位表示具体是什么错误?例如:01 为手机号不合法,02 为验证码输入错误,可标记 99 个错误。 Controller 层如何用?...:https://github.com/xinliangnote/go-gin-api/blob/master/pkg/errno/errno.go 定义错误码:https://github.com/xinliangnote.../go-gin-api/blob/master/internal/api/code/code.go Controller https://github.com/xinliangnote/go-gin-api...问题思考 1、提供对外接口时,如何进行安全的签名验证? 2、接口的幂等性如何设计? 3、如何统一对返回数据进行敏感数据脱敏? 4、如何设计接口日志,便于接口联调时快速进行错误定位?

    1.4K10

    Salesforce的SQL API

    或者Cast Iron的Salesforce Adapter都能实现,最开始我们找到了Salesforce的Analytic API,是Salesforce的报表数据API,试用了下,用的是REST+JSON...如果说面向OLTP通过API开放了应用,那面向OLAP通过SQL API开放了数据,也就是DaaS的开放了。...此外我们在研究开源API方案时候,发现WSO2的DSS也有类似可以将数据源快速暴露成Web Service和API,但详细对比下,WSO2的DSS只能通过IT人员来写SQL发布WSDL,还是一个典型的On-Premise...模式,并不能像Salesforce这样,可以将这个灵活性全部交给用户,用户可以自定义SQL,完全是个On-Demand的Cloud模式。...我们试图分析技术上如何实现,WSO2的DSS这类On-Premise发布的WSDL是紧耦合在数据上,也就是说如果数据变了,如字段增加和减少,WDSL是要IT人员重新发布的,而Salesforce的WSDL

    1.5K10

    云硬盘状态错误怎么办 如何格式化云硬盘?

    因为一旦硬盘出现故障,那么云服务器的许多联网操作都将受到影响,甚至会引起系统瘫痪和故障,因此出现硬盘问题要及时处理,如果云硬盘状态错误怎么办呢? 云硬盘状态错误怎么办? 云硬盘状态错误怎么办?...云硬盘状态错误一般有好多种不同的表现形式,比如无法写入或者是状态异常。如果遇到这种情况要登录云硬盘的控制台,选择相关的云硬盘设置状态错误。硬盘的状态设置完成之后,就会出现删除卷的字样。...如何格式化云硬盘? 云硬盘状态错误怎么办的处理方式已经了解了,在遇到一些特殊情况下,是需要对云硬盘进行格式化的,那么格式化云硬盘的具体操作方式是怎样的呢?...然后选择所要格式化的硬盘名称,再对硬盘进行格式化就可以了。要注意如果原硬盘当中有重要内容,在格式化之前应当进行备份。 以上就是云硬盘状态错误怎么办的相关内容。

    2.1K10
    领券