文档中心
众安科技云开放网关SDK

 

使用步骤:

 

一、引入maven依赖:

 

<dependency>

 

<groupId>com.zhongan.tech</groupId>

 

<artifactId>anlink-openapi-sdk</artifactId>

 

<version>1.3.4-RELEASE</version>

 

</dependency>

 

二、初始化

 

IAnlinkClient client;

 

SDKConfig config = new SDKConfig(SDKConstants.ENV_DEV, accessKey, accessSecret);

 

// config.getRequestHeader().put(HeaderNames.X_ANLINK_SIGNATURE_METHOD, SignMethodEnum.SSIGN.getValue()); 该行配置可以替换成较快的签名方法

 

client = new DefaultAnlinkClient(config);

 

请保护您的accessSecret,如有泄露,请至科技云控制台废除该accessKey。并使用新的accessKey继续您的业务。

 

参数说明:

 

1、SDKConstants.ENV_DEV 环境变量。

 

可选的值包括:SDKConstants.ENV_DEV、SDKConstants.ENV_TEST、SDKConstants.ENV_UAT、SDKConstants.ENV_PRE、SDKConstants.ENV_PRD 对应会将请求发送至科技云开放API网关五套环境的外网地址。

 

如果想要走内网地址可以使用:config.setUrl("");重写配置。

 

内网地址:

 

测试:http://tech-anlink-openapi-gateway.test.za-tech.net/

 

预发:http://tech-anlink-openapi-gateway.pre.za-tech.net/

 

生产:http://tech-anlink-openapi-gateway.prd.za-tech.net/

 

2、accessKey、accessSecret。这两个参数用于身份校验和签名验证。

可以向业务方索取。如果有安链云账号也可以登录安链云后台,通过如图

1、用户中心——>2、应用秘钥管理——>3、应用秘钥列表,查看。

 

图中4所指功能按钮可以用来绑定所购买的规格产品及查看AK所拥有的API。

 

如果AK没有该API,调用时会返回:鉴权失败!

 

 

三、定义request对象

 

AnlinkRequest request= new AnlinkRequest();

 

String uri = "/x-man/api/v1/message/smssend"; // /man/规则需要在网关事先配置

 

                                                      // 如果绑定过API ,可以在上图标识4的区域点击查看获取到

 

request.setUri(uri);

 

request.setMethodType(MethodType.GET);//默认post 可以不写

 

request.setIfSignPostBody(LogicEnum.YES); //post类型请求是否签名postbody 默认为NO·可以不写

 

request.setContentType("application/json"); //默认为"application/json" 可以不写

 

request.setAccept("application/json"); //默认为"application/json" 可以不写

 

request.putRequestParam(key1,value1); // 该方法用来设置queryString中参数,该参数参与签名  该参数即URL上“?”后面拼接的参数

 

request.putRequestParam(key2,value2);

 

Map<String,Object> postData = new HashMap<String, Object>();

 

postData.put(key,value);

 

request.setPostData(postData); //此处用来设置postData,具体参数设置参考短信接入wiki文档    https://wiki.zhonganonline.com/pages/viewpage.action?pageId=37615021  

 

四、发送请求

 

String result =client.doAction(request); //触发调用 不用修改

 

请注意:SDK默认使用公网通信,如使用默认地址请保证您的服务器可访问公网!!!如因网络不通且未自行检查打通,出现的生产问题概不负责!