Java

最近更新时间:11/9/2023, 4:21:59 PM作者:andrewren(任豪)

简介

  • 本文以 Java SDK 为例,介绍如何使用、调试并接入工业云OpenAPI。

依赖环境

  • JDK 7版本及以上。
  • 获取安全凭证。安全凭证包含 SecretId 及 SecretKey 两部分。SecretId 用于标识 API 调用者的身份,SecretKey 用于加密签名字符串和服务器端验证签名字符串的密钥,获取密钥需向工业云申请获取。

!您的安全凭证切勿泄露他人。

  • 获取调用地址。调用地址(endpoint)一般形式为*.{工业环境域名},模块的调用地址有一定区别,例如,商品的调用地址为product-mgmt-api.{工业环境域名},具体调用地址可参考对应的 API 文档

Jar包下载

前往 SDK 托管地址 下载Jar包使用。

maven本地引用jar

在工程根目录下创建lib文件夹,将jar复制进该文件夹。pom.xml添加如下配置

<dependency>
          <groupId>com.tencentcloud.industry</groupId>
          <artifactId>openapi-sdk-java</artifactId>
          <version>1.0</version>
          <scope>system</scope>
          <systemPath>${project.basedir}/lib/openapi-sdk-java-1.0-jar-with-dependencies.jar</systemPath>
        </dependency>

使用 SDK

示例1:商品列表(DescribeProducts)

以 查询商品列表 接口为例,创建DescribeProducts.java文件,并写入以下代码:

import v1.client.ProductClient;
import v1.common.Credential;
import v1.common.exception.TencentCloudSDKException;
import v1.common.profile.HttpProfile;
import v1.common.profile.Region;
import v1.model.product.DescribeProductsReq;
import v1.model.product.DescribeProductsRsp;

// 查询商品列表
public class DescribeProducts {
public static void main(String[] args) {
Credential cred = new Credential(
"secretid",
"secretkey");
// 实例化一个http选项,可选的,没有特殊需求可以跳过
HttpProfile httpProfile = new HttpProfile();
// post请求(默认为post请求) API3方式接口皆为Post请求
httpProfile.setReqMethod("POST");
// 在外网互通的网络环境下支持http协议(默认是https协议),请选择(https:// or http://)
httpProfile.setProtocol(HttpProfile.REQ_HTTP);
httpProfile.setEndpoint("product-mgmt-app-api.delivery.wedev.cool");

ProductClient productClient = new ProductClient(
cred, Region.Guangzhou.getValue(), httpProfile);

// 通过client对象调用DescribeProducts方法发起请求。注意请求方法名与请求对象是对应的
// 返回的resp是一个DescribeProductRsp类的实例,与请求对象对应
// 实例化一个Product实例信息查询请求对象,每个接口都会对应一个request对象。
DescribeProductsReq productReq = new DescribeProductsReq();
// 填充请求参数,这里request对象的成员变量即对应接口,可以文档或跳转到request对象的定义处查看请求参数的定义
productReq.setBidSet(new int[]{1001});                          // bid寻找Helper申请确认
productReq.setProductSourceSet(new String[]{"iop_third"});      // 平台接入产品默认为 iop_third
DescribeProductsRsp productRsp = null;
try {
productRsp = productClient.DescribeProducts(productReq);
System.out.println(DescribeProductsRsp.toJsonString(productRsp));
} catch (TencentCloudSDKException e) {
e.printStackTrace();
}

}

}

更多示例

您可以在 SDK 中的examples目录下获取更多详细的示例。