Postman测试金蝶云星空Webapi【协同开发云】

已于 2024-04-11 09:33:15 修改
阅读量3.2k 收藏 19
点赞数 27
分类专栏： 金蝶云星空 开发工具 小技巧 文章标签： postman 测试工具 经验分享
于 2023-10-31 11:46:54 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_33881408/article/details/134123421
版权

文章目录

Postman测试金蝶云星空Webapi【协同开发云】

环境说明

金蝶协同开发云环境
工作目录空间：D:\WorkSpace\开发商码
协同账套映射到本机的1200端口

//本机K3网址
http://localhost:1200/k3cloud

业务背景

基于金蝶云星空提供的接口测试，交付之前或者联调之前开发者先自测，即使纠错，提高效率。

大致流程

先请求登录接口，获得token后再请求标准webapi或者自定义接口，这样上下文才不会空。

具体操作

请求类型： POST
地址格式：http://localhost:1200/k3cloud/对应的方法拼接结构体

请求登录接口

请求地址

http://localhost:1200/Kingdee.bos.webapi.ServicesStub.authservice.validateuser.common.kdsvc

请求json：

{
    "acctid":"账套id",
    "userName":"账号",
    "password":"密码",
    "lcid":2052
}

accid：账套ID

userName：用户名

password：密码

lcid：语言【2052代表中文】
请求头：
在这里插入图片描述

在这里插入图片描述

返回以上信息代表登录成功。

请求标准接口

查看

请求方式：POST
请求地址：

http://localhost:1200/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.View.common.kdsvc

请求体构建json：

{
    "formid":"XXXX_AS_ProductLibrary",
    "data":{
    "CreateOrgId": 0,
    "Number": "ZDY00000009HDC",
    "IsSortBySeq": "false"
    }
}

在这里插入图片描述

响应结果：
在这里插入图片描述

保存

请求方式：POST
请求地址：

http://localhost:1200/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save.common.kdsvc

请求体构建json：

{
    "formid":"XXXX_AS_ProductLibrary",
    "data":{
    "NeedUpDateFields": [],
    "NeedReturnFields": [],
    "IsDeleteEntry": "true",
    "SubSystemId": "",
    "IsVerifyBaseDataField": "false",
    "IsEntryBatchFill": "true",
    "ValidateFlag": "true",
    "NumberSearch": "true",
    "IsAutoAdjustField": "false",
    "InterationFlags": "",
    "IgnoreInterationFlag": "",
    "IsControlPrecision": "false",
    "ValidateRepeatJson": "false",
    "Model": {
        "FID": 0,
        "FNumber": "XLH20231031001",
        "FCreateOrgId": {
            "FNumber": "10"
        },
        "FUseOrgId": {
            "FNumber": "10"
        },
        "FName": "序列号001",
        "FCustId": {
            "FNUMBER": "CUST0001"
        },
        "FOrderNum": "SO2023001",
        "FOrderInt": 2,
        "FMaterialId": {
            "FNUMBER": "010101076"
        },
        "FQty": 1,
        "FProductionDate": "2023-10-17 00:00:00",
        "FExpirationDate": "2023-12-16 00:00:00",
        "FOutStockDate": "2023-10-31 11:13:25",
        "FOutStockrNum": "XSCK001",
        "FRemark": "测试备注",
        "FDefinerOute": "test",
        "FDeliveryNoticeNo": "D20231031001"
    }
}
}

在这里插入图片描述
在这里插入图片描述

响应结果：

{
    "Result": {
        "ResponseStatus": {
            "IsSuccess": true,
            "Errors": [],
            "SuccessEntitys": [
                {
                    "Id": 106428,
                    "Number": "XLH20231031001",
                    "DIndex": 0
                }
            ],
            "SuccessMessages": [],
            "MsgCode": 0
        },
        "Id": 106428,
        "Number": "XLH20231031001",
        "NeedReturnData": [
            {}
        ]
    }
}
提交

请求方式：POST
请求地址：

http://localhost:1200/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Submit.common.kdsvc

请求体：

{
     "formid":"XXXX_AS_ProductLibrary",
     "data":{
        "CreateOrgId": 0,
        "Numbers": ["XLH20231031001","XLH20231031002"],
        "Ids": "",
        "SelectedPostId": 0,
        "NetworkCtrl": "",
        "IgnoreInterationFlag": ""
    }
}

在这里插入图片描述
响应结果

{
    "Result": {
        "ResponseStatus": {
            "IsSuccess": true,
            "Errors": [],
            "SuccessEntitys": [
                {
                    "Id": 106427,
                    "Number": "XLH20231031001",
                    "DIndex": 0
                },
                {
                    "Id": 106428,
                    "Number": "XLH20231031002",
                    "DIndex": 1
                }
            ],
            "SuccessMessages": [],
            "MsgCode": 0
        }
    }
}

在这里插入图片描述

审核

请求方式：POST
请求地址：

http://localhost:1200/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Audit.common.kdsvc

请求体：

{
     "formid":"XXXX_AS_ProductLibrary",
     "data":{
        "CreateOrgId": 0,
        "Numbers": ["XLH20231031001","XLH20231031002"],
        "Ids": "",
        "SelectedPostId": 0,
        "NetworkCtrl": "",
        "IgnoreInterationFlag": ""
    }
}

在这里插入图片描述
响应结果

{
    "Result": {
        "ResponseStatus": {
            "IsSuccess": true,
            "Errors": [],
            "SuccessEntitys": [
                {
                    "Id": 106427,
                    "Number": "XLH20231031001",
                    "DIndex": 0
                },
                {
                    "Id": 106428,
                    "Number": "XLH20231031002",
                    "DIndex": 1
                }
            ],
            "SuccessMessages": [],
            "MsgCode": 0
        }
    }
}

在这里插入图片描述

反审核

请求方式：POST
请求地址：

http://localhost:1200/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.UnAudit.common.kdsvc

请求体：

{
     "formid":"XXXX_AS_ProductLibrary",
     "data":{
        "CreateOrgId": 0,
        "Numbers": ["XLH20231031001","XLH20231031002"],
        "Ids": "",
        "SelectedPostId": 0,
        "NetworkCtrl": "",
        "IgnoreInterationFlag": ""
    }
}

在这里插入图片描述
响应结果

{
    "Result": {
        "ResponseStatus": {
            "IsSuccess": true,
            "Errors": [],
            "SuccessEntitys": [
                {
                    "Id": 106427,
                    "Number": "XLH20231031001",
                    "DIndex": 0
                },
                {
                    "Id": 106428,
                    "Number": "XLH20231031002",
                    "DIndex": 1
                }
            ],
            "SuccessMessages": [],
            "MsgCode": 0
        }
    }
}

在这里插入图片描述

撤销

请求方式：POST
请求地址：

http://localhost:1200/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.CancelAssign.common.kdsvc

请求体和响应体都和提交、审核、反审核一致。

请求自定义接口

参数是字符串

请求方式：POST
请求地址：

http://localhost:1200/XXXX.K3.SCM.WebApi.ServicesStub.AfterOrder.GetAfterOrder.common.kdsvc

请求体构建json：

{
    "customer":"XXXX电气有限公司"
}

在这里插入图片描述
响应结果
在这里插入图片描述

参数是实体类
单个实体类

请求方式：POST
请求地址：

http://localhost:1200/XXXX.K3.SCM.WebApi.ServicesStub.AfterOrder.GetAfterOrders.common.kdsvc

请求体构建json：

{
    "ai":
        {
        "Cust":"ZZZZ电气有限公司",
        "Number":"",
        "Name":"蝴蝶床"
    }
}

在这里插入图片描述
响应结果：
在这里插入图片描述

实体类是集合

请求方式：POST
请求地址：

http://localhost:1200/XXXX.K3.SCM.WebApi.ServicesStub.AfterOrder.GetAfterOrderList.common.kdsvc

请求体构建json：

{
    "aiList":
        [{
        "Cust":"XXXX电气有限公司",
        "Number":"",
        "Name":"蝴蝶床"
    },{
        "Cust":"ZZZZ电气有限公司",
        "Number":"",
        "Name":"床"
    }]
}

在这里插入图片描述
响应结果
在这里插入图片描述

其他

请求类型是POST如果改成GET请求，会报错
报错截图
在这里插入图片描述

响应结果：

{
    "actionname": "ShowErrMsg",
    "params": [
        {
            "errorTitle": "金蝶温馨提示: 应用服务器发生错误，请联系系统管理员检修！",
            "errorInfo": "发生时间：\t2023-10-31 09:54:53\r\n错误编号：\t500\r\n错误信息：\t索引超出范围。必须为非负值并小于集合大小。\r\n参数名: index\r\n===================================================\r\n调用堆栈：\r\n   在 System.Collections.ArrayList.get_Item(Int32 index)\r\n   在 System.Collections.Specialized.NameValueCollection.GetKey(Int32 index)\r\n   在 System.Web.HttpValueCollection.Get(Int32 index)\r\n   在 Kingdee.BOS.ServiceFacade.KDServiceFx.JQueryRequestExtractor.GetByGet(HttpRequest request) 位置 d:\\k3cloudbuild\\BOS_V7_PT\\BOS\\ServiceFacade\\Src\\Kingdee.BOS.ServiceFacade.KDServiceFx\\Pipeline\\JQueryRequestExtractor.cs:行号 35\r\n   在 Kingdee.BOS.ServiceFacade.KDServiceFx.RequestExtractor.Create(HttpRequest request) 位置 d:\\k3cloudbuild\\BOS_V7_PT\\BOS\\ServiceFacade\\Src\\Kingdee.BOS.ServiceFacade.KDServiceFx\\Pipeline\\RequestExtractor.cs:行号 50\r\n   在 Kingdee.BOS.ServiceFacade.KDServiceFx.KDSVCHandler.ProcessRequest(HttpContext context) 位置 d:\\k3cloudbuild\\BOS_V7_PT\\BOS\\ServiceFacade\\Src\\Kingdee.BOS.ServiceFacade.KDServiceFx\\HttpHandlers\\KDSVCHandler.cs:行号 20\r\n   在 System.Web.HttpApplication.CallHandlerExecutionStep.System.Web.HttpApplication.IExecutionStep.Execute()\r\n   在 System.Web.HttpApplication.ExecuteStepImpl(IExecutionStep step)\r\n   在 System.Web.HttpApplication.ExecuteStep(IExecutionStep step, Boolean& completedSynchronously)\r\n\r\n"
        }
    ]
}

因此请求类型不可以混用，要对，基本就是POST请求。

POST请求和WebAPI之间的区别是：

  1. POST请求是HTTP协议的一种请求方式，用于向服务器提交数据，通常用于表单提交数据；而WebAPI是一种服务，提供了一组RESTful接口，用于向服务器请求数据。

  2. POST请求是一种客户端向服务器发送数据的方式，通常用于表单提交等场景；而WebAPI则是一种服务器端提供数据的方式，客户端可以通过接口从服务器获取数据。

  3. POST请求需要指定请求的URL和提交的数据，服务器可以根据请求的URL来处理数据；而WebAPI则需要客户端通过URL和参数指定要请求的数据，服务器在接收到请求后返回所需的数据。

总之，POST请求和WebAPI服务是两种不同的概念，POST请求用于提交数据，而WebAPI用于提供数据服务。

懒人咖
关注
  • 27
    点赞
  • 踩
  • 19
    收藏
    觉得还不错? 一键收藏
  • 4
    评论
专栏目录
Postman导入E云API教程
l897385237l的专栏
05-26 3462
Postman导入E云API教程一、下载Postman二、打开Postman三、API测试 一、下载Postman 首先我们需要下载Postman工具，打开官方地址，直接点击下载 二、打开Postman 下载成功后，我们直接打开Postman，接下来就直接如图操作 三、API测试 ...
金蝶云星空_新版WebAPI资料包.rar
04-16
金蝶云星空_新版WebAPI资料包
金蝶云星空和四化智造MES（API）单据接口对接
CUNCAOSVEN的博客
05-20 481
轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。“MES助力智能制造过程控制:MES管理生产订单的整个生产流程,通过对生产过程的所有突发事件实时监控,自动纠正生产过程中的错误或提供决策支持,以实现生产调度要求;任务派工:MES在生产计划完成后,自动生成任务派工单,根据生产设备实际加工能力的变化,制定并优化生产的具体过程及各设备的详细操作顺序。
ASP.Net.WebAPI和工具PostMan
星河队长
06-24 1133
WebAPI 是一种传统的方式，用于构建和暴露 RESTUI风格的Web服务。它提供了丰富的功能和灵活性，可以处理各种HTTP请求，并支持各种数据格式，如JSON、XML等。WebAPI使用控制器(Controllers)和动作方法(ActionMethods)的概念、通过路由配置将请求映射到相应的方法上。开发人员可以使用各种属性和过滤器来处理请求、控制访问权限、验证数据等。Postman是一款API测试和开发环境的软件，旨在简化API开发过程、测试和文档编制。
如何通过API方式集成金蝶ERP
EDI电子数据交换 | 知行软件
02-22 1975
金蝶云星空简介 金蝶云是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。整个产品采用SOA架构，完全基于BOS平台组建而成，包含企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。目前，越来越多的企业选用金蝶云作为ERP系统。 集成方式 当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越
金蝶云星空之WebAPI开发（Android）----登录
Yxisobai的博客
12-06 2805
记录一下开发过程遇到的坑。因为金蝶云在webapi开发能查阅到的资料少之又少，java有些SDK包用不了，或者版本不兼容等各种问题。故再此记录一下用okhttp的方法来调用api接口。
金蝶云星空之WebAPI开发（Android）----单据查询
Yxisobai的博客
12-06 3039
记录一下开发过程遇到的坑。因为金蝶云在webapi开发能查阅到的资料少之又少，java有些SDK包用不了，或者版本不兼容等各种问题。故再此记录一下用okhttp的方法来调用api接口。接上一篇博客，获取到cookie后，传到数据页（emmm。。。activity传值，和fragment传值都会吧？我布局里用到fragment，自己挖坑给自己跳。。。后面总结篇会讲这些坑。。。）好了，言归正传，继续码代码。
接口测试之Postman使用全图文指南(原来使用Postman测试API接口如此简单)
热门推荐
软测小生
06-28 20万+
Postman是一个可扩展的API开发和测试协同平台工具，可以快速集成到CI/CD管道中。旨在简化测试和开发中的API工作流，如：使用Newman运行Postman集合 Postman 工具有 Chrome 扩展和独立客户端，推荐安装独立客户端。 Postman 有个 Workspace 的概念，workspace 分 personal 和 team 类型。Personal workspace 只能自己查看。...
Postman下载及WebApi测试遇到问题点
Violinlins
09-06 490
Postman WebApi
Postman webapi接口测试（二）
nnn_net的博客
06-26 7931
上一篇文章我们了解了WebAPI的搭建以及方法的调用传参，本篇文章主要教大家如何进行接口调试。1.首先下载postman安装包，下载地址：（在我的资源里 暂时没有审核通过 通过了改链接 要是一直不通过你们就到官网去下一个吧~）2.安装完成以后的界面是这个样子的：3.根据上一篇文章中的两个测试方法，我们在这里输入url以及参数，首先是Get请求的：4.点击send，我们看到请求成功并得出结果：5.接...
金蝶云（K3/cloud）webapi 开发实例
02-08
金蝶云（K3/cloud）WebAPI开发实例是针对企业级财务管理软件金蝶云的API接口进行编程实践的示例项目。金蝶云，原名K3，是金蝶国际软件集团推出的一款云端ERP解决方案，它为企业提供了全面的财务、供应链、生产制造等...
星空WebAPI.postman-collection
06-03
《金蝶云星空WebAPI在Postman中的调试实践》 在现代企业信息化管理中，金蝶云星空系统作为一款先进的ERP解决方案，提供了丰富的WebAPI接口，使得开发者可以通过编程方式与系统进行交互，实现自动化数据处理和集成。...
金蝶云 自定义WebAPI接口 c#程序示例.rar
01-17
在C#中开发对接金蝶云的WebAPI接口，你需要了解以下关键知识点： 1. **金蝶云API文档**：首先，你需要查阅金蝶云提供的官方API文档，了解可用的API接口、请求方法（GET、POST等）、请求参数、返回格式（通常为JSON...
金蝶云K3Cloud接口
07-27
金蝶云K3Cloud接口是金蝶公司为企业级客户提供的基于云计算技术的ERP解决方案的一部分，它允许开发者通过编程方式与金蝶K3Cloud系统进行交互，实现自动化业务流程或者定制化功能。本教程将深入探讨如何利用C#和Java...
Postman-win32-6.6.1，webapi测试工具
02-11
总的来说，Postman-win32-6.6.1是Web API开发和测试过程中不可或缺的工具，无论你是前端还是后端开发者，都能从中受益，提升你的API开发效率和质量。通过熟练掌握Postman，你可以更好地理解和控制你的API，确保它们...
使用Postman玩转腾讯云
12-10 1863
1. 简介 产品上云，那么作为产品的开发人员，其中一项重要的工作就是调用云厂商提供的API接口，来使用云产品。俗话说，工欲善其事，必先利其器。为了上云更轻松，我们需要一把利器来调用云厂商的API接口。接下来本文就向你介绍如何使用Postman这个API测试利器，来调用腾讯云API的接口，让你轻松玩转腾讯云。 2. Postman介绍 Postman是一个API开发协作平台。使用Postman...
postman接口测试实战篇
天然呆的人生若只如初见的博客
07-19 1002
首先思考两个问题：1.接口是什么？2.接口测试是什么？1.我们总是把接口想的很复杂，其实呢，它就是一个有特定输入和输出参数的交互逻辑处理单元，它不需要知道内部运行逻辑。2.接口测试，就是模拟调用方，通过接口通信来检测被测接口的正确性和容错性。
Postman的高级功能
最新发布
UnityBoy的博客
07-23 481
Postman是一款功能强大的API测试工具，它提供了许多高级功能来帮助开发者和测试人员更高效地进行API测试和开发。以下是Postman在API测试中的一些高级功能：
postman api测试
08-23
你好！关于 Postman API 测试，我可以为您提供一些基本信息。Postman 是一个非常流行的 API 开发和测试工具，它可以帮助开发人员在开发、测试和文档化 API 时更高效地工作。 使用 Postman 进行 API 测试有以下几个步骤： 1. 安装 Postman：首先，您需要在您的计算机上安装 Postman。您可以从 Postman 官方网站（https://www.postman.com/）下载并安装适用于您操作系统的版本。 2. 创建请求：打开 Postman 后，您可以创建一个新的请求。选择请求的请求方法（GET、POST、PUT等）以及目标 URL。您还可以选择添加请求头、请求参数和请求体等。 3. 发送请求：配置请求后，您可以点击 "Send" 按钮发送请求。Postman 将发送该请求到指定的 API 地址，并返回响应结果。 4. 断言和验证：一旦您收到响应，您可以使用 Postman 提供的断言功能来验证响应结果是否符合预期。您可以使用断言来检查状态码、响应体中的值、响应时间等。 5. 高级功能：除了基本的请求和断言功能之外，Postman 还提供了许多其他高级功能，如身份验证、环境变量、测试脚本等。这些功能可以帮助您更好地管理和组织测试套件。 希望这些信息对您有所帮助！如果您有任何进一步的问题，欢迎继续提问。
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值