Postman测试金蝶云星空Webapi【协同开发云】
作者:mmseoamin日期:2024-04-27

文章目录

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

              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代表中文】

              请求头:

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第1张

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第2张

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

              请求标准接口

              查看

              请求方式:POST

              请求地址:

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

              请求体构建json:

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

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第3张

              响应结果:

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第4张

              保存

              请求方式: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"
                  }
              }
              }
              

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第5张

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第6张

              响应结果:

              {
                  "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": ""
                  }
              }
              

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第7张

              响应结果

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

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第8张

              审核

              请求方式: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": ""
                  }
              }
              

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第9张

              响应结果

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

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第10张

              反审核

              请求方式: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": ""
                  }
              }
              

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第11张

              响应结果

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

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第12张

              撤销

              请求方式: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电气有限公司"
              }
              

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第13张

              响应结果

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第14张

              参数是实体类
              单个实体类

              请求方式:POST

              请求地址:

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

              请求体构建json:

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

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第15张

              响应结果:

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第16张

              实体类是集合

              请求方式:POST

              请求地址:

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

              请求体构建json:

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

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第17张

              响应结果

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第18张

              其他

              请求类型是POST如果改成GET请求,会报错

              报错截图

              Postman测试金蝶云星空Webapi【协同开发云】,在这里插入图片描述,第19张

              响应结果:

              {
                  "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用于提供数据服务。