云凤蝶(移动建站平台)快速接入

第一步:创建应用并获取APPID

要在您的应用中使用支付宝开放产品的接口能力,您需要先去支付宝开放平台(open.alipay.com),在开发者中心创建登记您的应用,并提交审核,审核通过后会为您生成应用唯一标识(APPID),并且可以申请开通开放产品使用权限,通过APPID您的应用才能调用开放产品的接口能力。需要详细了解开放平台创建应用步骤请参考《开放平台应用创建指南》。

第二步:配置密钥

开发者调用接口前需要先生成RSA密钥,RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY)。生成密钥后在开放平台开发者中心进行密钥配置,配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详情请参考《配置应用环境》。

第三步:搭建和配置开发环境

1.下载服务端SDK 

为了帮助开发者调用开放接口,我们提供了开放平台服务端SDK,包含JAVA、PHP和.NET三个语言版本,封装了签名&验签、HTTP接口请求等基础功能。请先下载对应语言版本的SDK并引入您的开发工程。

各语言版本服务端SDK详细使用说明,请参考《服务端SDK使用说明

2.接口调用配置

在SDK调用前需要进行初始化,代码如下:

AlipayClient alipayClient = new DefaultAlipayClient(URL, APP_ID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE);

关键参数说明:

配置参数 示例值解释 获取方式/示例值
URL 支付宝网关(固定) https://openapi.alipay.com/gateway.do
APPID APPID 即创建应用后生成 获取见上面创建应用并获取APPID
APP_PRIVATE_KEY 开发者私钥,由开发者自己生成 获取详见上面配置密钥
FORMAT 参数返回格式,只支持json json(固定)
CHARSET 编码集,支持GBK/UTF-8 开发者根据实际工程编码配置
ALIPAY_PUBLIC_KEY 支付宝公钥,由支付宝生成 获取详见上面配置密钥
SIGN_TYPE 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
TIPS:ISV/开发者可以通过“第三方应用授权”得到商户授权令牌(app_auth_token)作为请求参数传入,实现代商户发起请求的能力;具体方法请参考第三方应用授权

第四步:接口调用

接口调用流程

 

 SDK代码示例

查询应用可用的H5模板列表

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APPID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY,"RSA2");
AlipayMarketingToolFengdieTemplateQueryRequest request = new AlipayMarketingToolFengdieTemplateQueryRequest();
request.setBizContent("{" +
"    \"page_number\":1," +
"    \"page_size\":10" +
"  }");
AlipayMarketingToolFengdieTemplateQueryResponse response = alipayClient.execute(request);
if(response.isSuccess()){
      System.out.println("调用成功");
} else {
      System.out.println("调用失败");
}

查询H5页面详情

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APPID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY,"RSA2");
AlipayMarketingToolFengdieActivityQueryRequest request = new AlipayMarketingToolFengdieActivityQueryRequest(); 
request.setBizContent("{" +
 "         \"activity_id\":100" +
 "    }"); 
AlipayMarketingToolFengdieActivityQueryResponse response = alipayClient.execute(request);
 if(response.isSuccess()){
      System.out.println("调用成功"); 
} else {
      System.out.println("调用失败"); 
}

创建H5页面

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APPID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY,"RSA2");
AlipayMarketingToolFengdieActivityCreateRequest request = new AlipayMarketingToolFengdieActivityCreateRequest();
request.setBizContent("{" +
"    \"template_id\":10000," +
"    \"activity\":{" +
"      \"title\":\"圣诞促销\"," +
"      \"name\":\"christmas-2016\"," +
"      \"offline_time\":\"2016-01-03 13:21:55\"," +
"        \"page\":[{" +
"                    \"name\":\"index.html\"," +
"          \"schema_data\":\"{\\\"schemas/config\\\":{\\\"goods\\\":[{\\\"title\\\":\\\"第一个\\\",\\\"price\\\":\\\"20.00\\\"}]}}\"" +
"          }]" +
"    }" +
"  }");
AlipayMarketingToolFengdieActivityCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
    System.out.println("调用成功");
} else {
    System.out.println("调用失败");
}

唤起H5页面编辑器

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APPID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY,"RSA2");
AlipayMarketingToolFengdieEditorQueryRequest request = new AlipayMarketingToolFengdieEditorQueryRequest();
request.setBizContent("{" +
"    \"activity_id\":100," +
"    \"redirect_url\":\"https://open.alipay.com/activity/callback\"" +
"  }");
AlipayMarketingToolFengdieEditorQueryResponse response = alipayClient.execute(request);
if(response.isSuccess()){
    System.out.println("调用成功");
} else {
    System.out.println("调用失败");
}
onlineServer