API测试计划文档标准

Question

我有一个问题要问有经验的API测试人员，特别是那些在大型组织工作的人。我的任务是识别API测试计划文档的任何行业标准。到目前为止，我已经发现IEEE829标准和ISO 29119可以用于一般的软件测试。

然而，是否有任何最好的实践，指南或标准的文件API测试计划，特别是您可以从您的经验推荐？

Answer 1

我的个人观点：

高级别的

用烟雾、快乐和悲伤的测试测试API端点、状态代码和数据

在一个详细的层次上，我们需要问以下问题。

答案将指导测试的内容和方法。

• 有什么文件？
• 它提供了什么功能？
• 它支持并发吗？
• API端点是什么？
• API是内部的还是外部的？
• 哪些端点是幂等的？
• 端点是无状态的还是有状态的？
• 是否有任何工作流*1因客户端而异？
• 是否有性能要求？
• API端点是否构成工作流？
• 对数据的预期验证是什么？
• API后面是什么系统或库？
• 我们需要模拟依赖服务吗？
• 它是否限制了交通，也就是速率限制？
• 使用了什么版本控制方法(如果有的话)？
• API支持多种语言吗？
• 如果已经使用了SOAPui，它是如何集成的？
• API是否仅限于一个国家或地区？
• 它是否提供特定语言的客户端存根？
• 对于给定的端点，期望使用什么状态代码？
• 数据存在什么域格式和结构？
• API是否使用HATEOS*2作为自文档？
• 可以执行什么样的数据验证/测试？
• 我使用的测试框架支持什么API？
• 执行了哪些操作，如GET、PUT、POST等？
• 我们是否需要准备相关的测试数据或服务？
• 需要哪些非API方法来验证数据？
• 是否有现有的API定义，例如WADL、WSDL、Thrift？
• 准备数据需要什么样的非API方法？
• 将使用什么(如果有的话)授权(什么)机制？
• 将使用什么(如果有的话)身份验证(‘谁’)机制？
• 谁将使用它，外部程序员还是其他内部模块？
• 什么格式(S)：肥皂，REST，GraphQL，ProtoBuffer，其他？

*1工作流通常需要多个API调用，它们之间可能存在依赖关系。

*2 HATEOS -超文本作为应用程序状态的引擎，它允许自发现API