当前位置：首页 > news >正文

测试金蝶云的OpenAPI

news 2025/8/10 16:03:47

如何使用Postman测试K3Cloud的OpenAPI

1. 引言

在本篇博客中，我将带你逐步了解如何使用Postman测试和使用K3Cloud的OpenAPI。内容包括下载所需的SDK文件、配置文件、API调用及测试等步骤。让我们开始吧！

2. 下载所需的SDK文件

2.1 获取SDK

首先，确保你下载了适用于你平台的SDK文件。你可以从K3Cloud官方API文档页面下载所需的SDK。

访问OpenAPI部分。
根据你的需求下载Java、PHP、Python等平台的SDK。

以下是从K3Cloud文档页面下载SDK的示例：

在这里插入图片描述
下载完成以后解压，并且阅读SDK使用说明文件，主要是申请第三方登录授权。

3. 配置SDK

3.1 编辑`kdwebapi.properties`文件

下载完SDK后，下一步是进行正确配置。打开kdwebapi.properties文件，你需要配置一些参数，如服务器地址、API密钥、认证凭证等，这些信息都需要根据你所在的K3Cloud实例来设置。

服务器地址：确保这个地址指向你的K3Cloud实例。
API密钥：你需要通过K3Cloud的授权门户申请密钥。

在这里插入图片描述

4. 在Postman中测试API

4.1 如何通过Postman测试登录接口

操作步骤如下：

打开Postman。
设置登录接口：
- API URL：http://localhost/K3Cloud/Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc
- 请求参数：输入必要的字段，如数据中心ID、用户名和密码，采用JSON格式。

示例：

{"parameters":["数据中心ID","用户名","密码","2052"]}

在这里插入图片描述
点击发送按钮获取响应。

4.2 查询元数据

为了获取数据，你需要使用以下API URL：

http://localhost/k3cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.QueryBusinessInfo.common.kdsvc

输入所需的查询参数，例如表单ID，具体的请求格式可以参考API文档。

示例：

{"parameters":[{"FormId":"BD_BANK"}]}

在这里插入图片描述
表单ID可以查看API文档。

4.3 查询单据

为了获取数据，你需要使用以下API URL：

http://localhost/k3cloud/Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExecuteBillQuery.common.kdsvc

输入所需的查询参数，例如表单ID、查询的字段集合等，具体的请求格式可以参考API文档。查询的字段集合可以在获取的元数据中查看。
在这里插入图片描述
示例：

{"parameters":[{"FormId":"BD_BANK","FieldKeys":"FNumber,FDescription,FCreateDate","Limit":2000,"TopRowCount":0,"StartRow":0,"FilterString":"","OrderString":"","SubSystemId":""}]
}

在这里插入图片描述

5. 测试物料查询API

以下是如何测试物料查询API的示例，获取关于物料（BD_Material）的信息：

5.1 Java代码示例

    /*本接口用于实现物料 (BD_Material)的单据查询功能*/@Testpublic void mtestQueryMaterial() throws Exception {var api = new K3CloudApi();String json = "{\n" +"    \"FormId\": \"BD_Material\",\n" +"    \"FieldKeys\": \"FMATERIALID,FNumber,FName,FCreateOrgId,FUseOrgId,\",\n" +"    \"FilterString\": \"\",\n" +"    \"OrderString\": \"\",\n" +"    \"TopRowCount\": 0,\n" +"    \"StartRow\": 0,\n" +"    \"Limit\": 2000,\n" +"    \"SubSystemId\": \"\"\n" +"}";String result = String.valueOf(api.executeBillQuery(json));System.out.println("物料单据查询接口: " + result);}

在这个代码示例中，我们通过executeBillQuery方法查询物料数据。
在这里插入图片描述

6. 结论

通过测试和集成K3Cloud的OpenAPI，你可以显著提升应用程序的功能，能够方便地通过编程方式获取和操作业务数据。使用Postman进行测试是验证配置是否正确的一个很好的方法，确保一切正常后，你可以更进一步进行复杂的集成。