- 综合排序
- 最热优先
- 最新优先
- 来自专栏测试开发干货
接口测试平台设计思路-3:成品总览
虽然说前端一般会控制好接口的传入字段，但是接口测试的主要思想就是要绕过前端测试接口本身。 首先来看我们接口的正常调试参数： 它url中有俩个参数，body里有1个参数 返回值是一段text文本： 然后我们点击保存后，点击这个接口的健壮测试按钮 页面就变成了这样 其中有接口的基本信息，和将要进行替换的三个参数。 所以最终会有大概3个参数*13门徒 = 39次请求。 那么点击执行按钮吧。 而且如果此接口需要先请求登陆态接口获取token等参数。那么在这里，虽然请求了39次之多，但是登陆态接口只会在一开始执行一次哦～
47120编辑于 2022-05-18 - 来自专栏陌无崖知识分享
HTTP接口设计
PUT,PATCH,OPTIONS方法 默认情况下请求实体会被视作标准 json 字符串进行处理，当然，依旧推荐设置头信息的 Content-Type 为 application/json 在一些特殊接口中 参数的介绍的修正 JSON Web Token，一种 Token 的生成标准 Json Web Tokens: Introduction Json Web Tokens: Examples 数据缓存 大部分接口应该在响应头中携带 Content-Location 跨域 CORS 接口支持“跨域资源共享”（Cross Origin Resource Sharing, CORS），这里和这里和这份中文资料有一些指导性的资料。 Access-Control-Max-Age: 86400 Access-Control-Allow-Credentials: true JSON-P 如果在任何 GET 请求中带有参数 callback ，且值为非空字符串，那么接口将返回如下格式的数据
2.6K20发布于 2020-07-27 - 来自专栏斑斓
面向接口设计与角色接口
标签 | 软件设计 字数 | 1876字 阅读 | 5分钟 问题：在做项目的时候，是不是所有包含非静态方法的类，都要写一个接口？是因为这样的目的是为了解耦，然后通过DI注入实现吗？ 此外，如果你的接口永远都只有一个实现类，并没有任何可能的需求变化，那么还有必要解耦吗？ 所以说，不能死板的将类的方法提取接口，然后美其名曰为面向接口设计。 我们不能误解“面向接口设计”原则，该原则所指的“接口”并非Java语言中的interface类型，而是指面向调用者对外暴露的接口，代表一种交互与协作，是对信息的隐藏和封装，而不是具体的interface 即使是普通的java方法仍然满足隐藏细节的原则，如果是public的，就可以认为该方法是“面向接口设计”中的接口，也就是说：不要针对实现细节编程，而是针对接口编程。 如果你先定义了一个类叫EmailService，然后因为你需要定义接口对其抽象，然后就简单地将这个类的所有公有方法都提取到抽象的接口中，这样设计的接口，被Martin Fowler称为Header Interface
99110发布于 2018-07-27 - 来自专栏全栈程序员必看
怎样设计接口？
怎样设计接口？ 众所周知，接口是提供给其它模块或者系统使用的一种约定或者规范。因此接口必需要保 证足够的稳定性和易用性。这是设计接口的基本要求。 这是一种糟糕的接口设计。既不便于使用又不便于编译器优化（待确认）。 3.怎样设计接口？ 採用OOD思想，即面向对象的思想，提供类接口或者COM接口。 对于C函数接口怎样设计呢？ 事实上和C++接口设计原则一样，也採用面向对象的思想，仅仅是 将类设计成结构，公共的成员函数变为全局的函数，私有的成员函数变为static函数就可以。 函数接口的第一參数就相当于C++中的this指针就可以。 4.接口设计的其它要求 * 规范性：主要是接口设计的代码规范，这是最主要的要求。
1.2K30编辑于 2022-07-13 PostIn从入门到精通(3) - 如何对接口快速设计并管理接口文档
PostIn是一款国产开源免费的接口管理工具，包含项目管理、接口调试、接口文档设计、MOCK、接口测试、测试计划等模块，支持免费私有化部署，一键安装零配置，支持免登陆本地接口调试，同时可以对项目进行灵活的成员权限 2、导入接口除了手动添加接口这个方式，PostIn还支持通过Postman/OpenAPI V3/Swagger V2的json格式导入。在目录右侧点击“+”，选择导入。 上传符合格式的json文件，点击提交，成功导入接口。3、设计接口接口设计通过设置基础信息、请求和输出结果的参数，来构造当前接口的具体使用方式。 HTTP 协议：设计涵盖了基础信息、请求参数和响应结果的设计。WebSocket 协议：设计涵盖了基础信息、请求参数的设计。请求参数：属性描述Header位于HTTP请求的头部，用于传递元数据。 5、查看接口文档接口文档基于接口设计自动生成，确保接口信息实时更新，便于团队随时查阅和对接，支持 HTTP 和 WebSocket 协议，方便共享给其他开发者或团队成员。
34454编辑于 2025-11-24- 来自专栏自学测试之道
接口测试3
2、导入测试报告库文件HTMLTestRunner_PY3（这个文件在网上可以下载后[https://blog.csdn.net/cjh365047871/article/details/80181530 3、定义测试用例和测试报告存放路径、读取测试用例方法和测试报告格式 #! q=keitwo&page=1&type=note # @QQ交流 : 3227456102 import unittest,time import HTMLTestRunner_PY3 if _ + mail_from + ">", 'utf-8') message['To'] = ";".join(mail_to) message['Subject'] = Header(u"接口自动化测试报告 3、导入发送邮件模块 ? 4、运行结果 ?
58820发布于 2019-09-29 - 来自专栏子勰随笔
SDK设计心得之接口设计
由于SDK的特殊性，所以对于SDK的开发来说，一开始对于SDK的一些通用的整体的元素的设计至关重要。因为SDK（尤其很多平台SDK,使用的应用成百上千）一个及其细微的调整都会影响很多开发者的版本周期。 因此前期的设计显得尤为重要。关于这部分内容，我会分两篇来介绍，这篇重点介绍具体接口的设计。另一篇SDK设计心得之架构和资源将重点介绍SDK的架构和一些资源的使用方式。 关于接口设计 设计原则 接口名称、参数名称要足够清晰 一个牛逼的接口名称可以替代无数的注释 一个接口只做一件事 一个接口只做一件事。 我们有个功能有两个接口：一个是需要传参数，另一个不需要传参，两者的逻辑完全是独立的。本来是根据第一个原则设计了两个信、达也算雅的接口来实现。 其实这里游戏反映接入成本高，我们应该是去分析什么原因引起的接口成本身高，能不能优化。不能直观的认为一个功能要两个接口，接口太多了接入成本就高，就要删接口。
6.8K90发布于 2018-05-22 - 来自专栏python3
python3--归一化设计，接口类和抽象类，接口隔离原则，多态
抽象类与接口类 继承有两种用途 1 继承基类的方法，并且做出自己的改变或者扩展(代码重用) 2 声明某个子类兼容于某基类，定义一个接口类Interface,接口类中定义了一些接口名(就是函数名)且并未实现接口的功能 ”----这在程序设计上，叫做归一化 归一化使得高层的外部调用者可以不加区分的处理所有接口兼容的对象集合 依赖倒置原则： 高层模块不应该依赖底层模块，二者都应该依赖其抽象;抽象不应该依赖细节；细节应该依赖抽象 print('进程数据的写入方法') txt = Txt() # 实例化 sata = Sata() # 实例化 process = Process() # 实例化 # 这样情况，就是归一化设计 抽象类是一个介于类和接口之间的一个概念，同时具备类和接口的部分特性，可以用来实现归一化的设计 1 多继承问题 在继承抽象类的过程中，我们应该尽量避免多继承 而在继承接口的时候，我们反而鼓励你来多继承接口 接口隔离原则 使用多个专门的接口，而不使用单一的总接口。
2.8K10发布于 2018-08-02 - 来自专栏跟Qt君学编程
设计模式-流畅接口
何为流畅接口？先上代码String("1")("2")("3")("4")("5")。流畅接口从字面上看是用起来很顺手，究竟是有多顺手，又应用在哪里呢？相信你看完本文多少会有些答案了。 .append("5"); 在这里看来，append接口就是流畅接口了，它避免啰嗦的调用。 qDebug() << "1" << "2" << "3" << "4" << "5"; 头铁君出了名是头铁，还有其他的应用场合吗？ 来来来，别急。 ； 明确确定设置参数后需要调用build接口生效，这就意味着可以提醒接口调用者生效了那些参数。 让接口调用者用来顺手(流畅)。
97420发布于 2019-08-20 - 来自专栏测试开发社区
接口用例设计
背景说明 一个系统可为其他系统提供能力或者直接为UI层提供数据，在设计系统测试方案时应考虑上游调用的各种场景，不仅考虑顺利且正向思维操作的场景，还应逆向的场景。 换句话来说，使用契约式设计的方式，运行前条件必须满足，参数不正确不可运行；运行中内部状态必须不变；运行后结果必须保持一致。 在设计接口用例设计时，除实现功能外，应关注：幂等性、空校验、流程节点限制、异常校验。 ? 01 幂等性 何为幂等性？ 幂等为一数学概念，指使用相同参数重复执行，能获取相同结果。 对非空参数依次传空，观察接口调用情况。 当然，首先需明白业务逻辑，从而进行用例设计。尤其对于参数复杂的接口，当某一条调用规则下 某些非空参数就需要作为必传了。 明确系统的状态流转，一个系统设计初期就需明确功能及状态流转，会依据产品对系统的定义及依赖的下游或三方产品的功能。 测试正常流程节点。按照正向流程依次调用，观察调用结果及生成状态。
2.3K31发布于 2020-04-26 - 来自专栏编程园地
API接口TOKEN设计
API的特点： 1、因为是非开放性的，所以所有的接口都是封闭的，只对公司内部的产品有效； 2、因为是非开放性的，所以OAuth那套协议是行不通的，因为没有中间用户的授权过程； 3、接口分为需要用户登录才能访问的和不需要用户登录就可访问的 加密密钥'为私有的加密密钥，手机端需要在服务端注册一个“接口使用者”账号后，系统会分配一个账号及密码，数据表设计参考如下： 字段名及字段类型 client_id varchar(20) 客户端ID client_secret = md5('用户的uid' + 'Unix时间戳') = etye0fgkgk4ca2ttdsl0ae9a5dd77471fgf 服务端用数据表维护user_token的状态，表设计如下： 字段名及字段类型如下 表记录； 3、根据user_id，user_token 获取表记录，如果表记录不存在，直接返回错误，如果记录存在，则进行下一步； 4、更新user_token 的过期时间（延期，保证其有效期内连续操作不掉线 ）； 5、返回接口数据； 接口用例如下：添加测试接口 URL： http://www.api.com/demo/index/add-demo?
2.1K30编辑于 2022-03-02 【设计API接口原则】
如果当初设计API时只图自己省事，定了个死板的字段名、严格的校验规则，或者不预留扩展字段，现在被100个团队调用后，任何一个微小的改动都可能引发雪崩式的兼容性问题——那时候不只是别人骂我，我自己都想穿越回去抽自己 比如： 接受参数时，对非关键字段做宽松解析（比如容错大小写、允许空值、支持多种格式的时间字符串）； 返回结果里，保留未知字段而不是直接抛错，让调用方可以渐进式升级； 版本控制清晰，老接口至少留足半年的缓冲期 毕竟，一个接口的终点，可能是上百个系统的起点。 这句非常经典！这是API设计的黄金法则。当一个接口从内部自用扩展到外部生态时，设计复杂度会指数级上升。 // 设计一个用户信息查询API interface UserQueryRequest { userId? 预留字段、宽松校验、错误容忍，这些看似"偷懒"的设计，实际上是在为整个生态的稳定性买单。
26310编辑于 2025-12-18- 来自专栏大前端（横向跨端 & 纵向全栈）
RESTful 接口设计指南
因此，必须有一种统一的机制，方便不同的前端设备与后端进行通信，这导致 API 构架的流 行，甚至出现"API First"的设计思想，RESTful API 是目前比较成熟的一套互联网应用程序的 API 设计理论。 (1).https://api.baidu.com (2).https://api.qq.com 3. 应该将api的版本号放入URl中。 (3).PUT(UPDATE)，更新服务器资源。 (4).DELETE(DELETE)，删除服务器资源。 以下三个HTTP 请求方式不常用 (5).HEAD，获取资源的元数据。
88410发布于 2020-11-26 - 来自专栏Hercules
RESTful接口设计风格
遵循RESTful风格，可以使开发的接口通用性更好，统一规范，减少沟通、学习和开发的成本。
40910编辑于 2023-08-23 - 来自专栏PHP在线
API接口TOKEN设计
API的特点： 1、因为是非开放性的，所以所有的接口都是封闭的，只对公司内部的产品有效； 2、因为是非开放性的，所以OAuth那套协议是行不通的，因为没有中间用户的授权过程； 3、接口分为需要用户登录才能访问的和不需要用户登录就可访问的 加密密钥'为私有的加密密钥，手机端需要在服务端注册一个“接口使用者”账号后，系统会分配一个账号及密码，数据表设计参考如下： 字段名及字段类型 client_id varchar(20) 客户端ID client_secret = md5('用户的uid' + 'Unix时间戳') = etye0fgkgk4ca2ttdsl0ae9a5dd77471fgf 服务端用数据表维护user_token的状态，表设计如下： 字段名及字段类型如下 表记录； 3、根据user_id，user_token 获取表记录，如果表记录不存在，直接返回错误，如果记录存在，则进行下一步； 4、更新user_token 的过期时间（延期，保证其有效期内连续操作不掉线 ）； 5、返回接口数据； 接口用例如下：添加测试接口 URL： http://www.api.com/demo/index/add-demo?
5.9K140发布于 2018-03-09 - 来自专栏AI技术体系搭建过程
0226 rest接口设计
接口设计要求是： 1.简洁； 2.考虑到向后兼容； 业界有一些基本的原则： 1 restfull restfull是一种设计风格，一切接口皆是资源。 目前是设计的主流，思想也非常先进。 3 安全 这个怎么重要都不为过，接口设计必须考虑认证和授权，保证特定的人只能访问特定的资源。 同时需要注意在日志中不能含有用户和系统的敏感信息。 API设计实践 接口框架选型 有了接口设计的原则，可以挑选一个可靠的接口框架来支持自己的工作， 一个好的接口框架应该有如下特点： 对访问控制的支持； 自动测试的支持； 请求响应格式和序列化的支持； 日志和日志过滤的支持 3 谨慎使用AOP 面向切面编程可以在跟业务无关的垂直领域处理问题，比如日志，监控，解析等；可以提高代码的重用性和规范性； 但是也有缺点，比如，增加了测试和分析的难度，也对研发人员要求比较高。 ** 小结 通过本篇文章你可以学到如下内容： [ ] 接口设计的原则 [ ] 接口设计框架选型要点 [ ] 接口设计过程中的设计实践问题 设计良好的接口，可以提高软件的复用性，提高团队的输出效率和质量。
23600编辑于 2025-07-01 - 来自专栏程序那些事儿
如何设计api接口
随着前后端的分离，api 接口变得越来越重要，作为前后端通信的接口，api 变得非常重要，而且它的设计也是非常难以掌握。不仅要考虑安全性，还要考虑可维护性，以及今后的升级等等。 如何才能设计出更好的 api 接口，我认为以下几点需要注意。 接口一致性 这里说的一致性指的是编码规范要统一，不能各个接口使用不一样的编码风格。 接口健康性检查 我们应该设计一个监控系统或者一个接口来实时监控我们的服务，如果接口出现了问题，我们应该能够第一时间发现，同样，对于每个接口的访问请求我们都要有日志记录的存储。 尽量采用restful风格 虽然restful风格被一些人质疑，但是目前来看，它还是最好的接口设计风格，通过采用restful风格，可以让接口语义更加明确 ，规范，优雅省去了大部分 无意义的沟通，通过使用不同的 提供完整详细的api文档 无论我们的接口设计的多么规范，多么易懂，我们都需要提供一份完整的api文档，同时我们还需要提供一些请求范例，这样用户在使用的时候才会更加清楚，也能避免一些错误的请求。
1.2K50编辑于 2023-03-07 - 来自专栏四火的唠叨
关于接口设计，还有 Fluent Interface，这种有趣的接口设计风格
这个故事是从下面这样一个对外暴露接口的调用开始的。 QueryUserEvent.SEX_MALE); …… List<User> userList = userService.query(event); 我想做的事情其实很简单，我想查询一个用户列表，可是接口参数的拼装让我感到头疼 sex : User.SEX_MALE }, UserService.QUERY_TYPE_NORMAL); 不过，他接着说，在 Java 里面好像还没有类似简洁的表示方法…… 万幸的是，有一种接口连续调用的风格 greaterThan(new User().setAge(18)).setSex(User.SEX_MALE).query(UserService.QUERY_TYPE_NORMAL); 我想，这样的设计如果在数学计算的时候 对于 Fluent Interface 而言，它的接口调用既改变了对象的状态，又返回了对象（this 或其他），并不属于上面的两种类型。
54020编辑于 2022-07-15 - 来自专栏白驹过隙
架构设计 - 日志管理接口设计
在后端代码中，日志无处不在，设计一套自己的日志管理代码，给框架提供一套好用的日志接口将大大方便代码的开发。 其中在日志管理代码的编写中，主要有以下难点： 1.数目不确定的入参函数编写 2.日志权限控制 3.日志输出形式。 接口设计： 1.提供三类日志打印形式：1）控制台打印信息，类似printf的接口封装 2）函数追踪接口，打印当前代码的文件名，函数名及行，以及一些设定的输出参数 3）日志打印函数，提供打印级别控制，且打印内容输出到日志文件中 2.提供日志级别控制：1）在打印日志时提供当前日志级别，代码依据级别进行控制打印 2）日志打印级别控制暂时使用配置文件 ======================= 2 /* 3 * File: DMLogManager.h 4 * 5 * Author: bing 6 * 7 * Date: 2016
81340发布于 2018-06-25 - 来自专栏白驹过隙
架构设计 - 日志管理接口设计
在后端代码中，日志无处不在，设计一套自己的日志管理代码，给框架提供一套好用的日志接口将大大方便代码的开发。 其中在日志管理代码的编写中，主要有以下难点： 1.数目不确定的入参函数编写 2.日志权限控制 3.日志输出形式。 接口设计： 1.提供三类日志打印形式：1）控制台打印信息，类似printf的接口封装 2）函数追踪接口，打印当前代码的文件名，函数名及行，以及一些设定的输出参数 3）日志打印函数，提供打印级别控制，且打印内容输出到日志文件中 2.提供日志级别控制：1）在打印日志时提供当前日志级别，代码依据级别进行控制打印 2）日志打印级别控制暂时使用配置文件 ======================= 2 /* 3 * File: DMLogManager.h 4 * 5 * Author: bing 6 * 7 * Date: 2016
86580发布于 2018-05-18
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号