您现在的位置是:首页 > 技术教程 正文

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

admin 阅读: 2024-03-30
后台-插件-广告管理-内容页头部广告(手机)

文章目录

  • Postman测试金蝶云星空Webapi【协同开发云】
    • 环境说明
    • 业务背景
    • 大致流程
    • 具体操作
      • 请求登录接口
      • 请求标准接口
        • 查看
        • 保存
        • 提交
        • 审核
        • 反审核
        • 撤销
      • 请求自定义接口
        • 参数是字符串
        • 参数是实体类
          • 单个实体类
          • 实体类是集合
    • 其他

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

环境说明

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

//本机K3网址 http://localhost:1200/k3cloud
  • 1
  • 2

业务背景

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

大致流程

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

具体操作

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

请求登录接口

请求地址

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

请求json:

{ "acctid":"账套id", "userName":"账号", "password":"密码", "lcid":2052 }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

accid:账套ID

userName:用户名

password:密码

lcid:语言【2052代表中文】
在这里插入图片描述

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

请求标准接口

查看

请求方式:POST
请求地址:

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

请求体构建json:

{ "formid":"XXXX_AS_ProductLibrary", "data":{ "CreateOrgId": 0, "Number": "ZDY00000009HDC", "IsSortBySeq": "false" } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

在这里插入图片描述

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

保存

请求方式:POST
请求地址:

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

请求体构建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" } } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45

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

响应结果:

{ "Result": { "ResponseStatus": { "IsSuccess": true, "Errors": [], "SuccessEntitys": [ { "Id": 106428, "Number": "XLH20231031001", "DIndex": 0 } ], "SuccessMessages": [], "MsgCode": 0 }, "Id": 106428, "Number": "XLH20231031001", "NeedReturnData": [ {} ] } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
提交

请求方式:POST
请求地址:

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

请求体:

{ "formid":"XXXX_AS_ProductLibrary", "data":{ "CreateOrgId": 0, "Numbers": ["XLH20231031001","XLH20231031002"], "Ids": "", "SelectedPostId": 0, "NetworkCtrl": "", "IgnoreInterationFlag": "" } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11

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

{ "Result": { "ResponseStatus": { "IsSuccess": true, "Errors": [], "SuccessEntitys": [ { "Id": 106427, "Number": "XLH20231031001", "DIndex": 0 }, { "Id": 106428, "Number": "XLH20231031002", "DIndex": 1 } ], "SuccessMessages": [], "MsgCode": 0 } } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22

在这里插入图片描述

审核

请求方式:POST
请求地址:

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

请求体:

{ "formid":"XXXX_AS_ProductLibrary", "data":{ "CreateOrgId": 0, "Numbers": ["XLH20231031001","XLH20231031002"], "Ids": "", "SelectedPostId": 0, "NetworkCtrl": "", "IgnoreInterationFlag": "" } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11

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

{ "Result": { "ResponseStatus": { "IsSuccess": true, "Errors": [], "SuccessEntitys": [ { "Id": 106427, "Number": "XLH20231031001", "DIndex": 0 }, { "Id": 106428, "Number": "XLH20231031002", "DIndex": 1 } ], "SuccessMessages": [], "MsgCode": 0 } } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22

在这里插入图片描述

反审核

请求方式:POST
请求地址:

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

请求体:

{ "formid":"XXXX_AS_ProductLibrary", "data":{ "CreateOrgId": 0, "Numbers": ["XLH20231031001","XLH20231031002"], "Ids": "", "SelectedPostId": 0, "NetworkCtrl": "", "IgnoreInterationFlag": "" } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11

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

{ "Result": { "ResponseStatus": { "IsSuccess": true, "Errors": [], "SuccessEntitys": [ { "Id": 106427, "Number": "XLH20231031001", "DIndex": 0 }, { "Id": 106428, "Number": "XLH20231031002", "DIndex": 1 } ], "SuccessMessages": [], "MsgCode": 0 } } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22

在这里插入图片描述

撤销

请求方式:POST
请求地址:

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

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

请求自定义接口

参数是字符串

请求方式:POST
请求地址:

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

请求体构建json:

{ "customer":"XXXX电气有限公司" }
  • 1
  • 2
  • 3

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

参数是实体类
单个实体类

请求方式:POST
请求地址:

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

请求体构建json:

{ "ai": { "Cust":"ZZZZ电气有限公司", "Number":"", "Name":"蝴蝶床" } }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

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

实体类是集合

请求方式:POST
请求地址:

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

请求体构建json:

{ "aiList": [{ "Cust":"XXXX电气有限公司", "Number":"", "Name":"蝴蝶床" },{ "Cust":"ZZZZ电气有限公司", "Number":"", "Name":"床" }] }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

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

其他

请求类型是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" } ] }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

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

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

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

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

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

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

标签:
声明

1.本站遵循行业规范,任何转载的稿件都会明确标注作者和来源;2.本站的原创文章,请转载时务必注明文章作者和来源,不尊重原创的行为我们将追究责任;3.作者投稿可能会经我们编辑修改或补充。

在线投稿:投稿 站长QQ:1888636

后台-插件-广告管理-内容页尾部广告(手机)
关注我们

扫一扫关注我们,了解最新精彩内容

搜索
排行榜