为了让开发者快捷开发接入,力方开放平台推出了SDK开发包,SDK是由程序自动化生成的代码包,其中包含了开放平台已经开放的API,封装了API调用的请求入入参,签名加密,返回值解析等一些必要的功能,目前开放平台提供的版本如下:
Java SDK支持1.6及以上
.NET SDK支持.NET 3.5及以上
PHP SDK支持PHP5及以上
截止目前,力方开放平台已推出JAVA、PHP以及.NET等版本的SDK,另外在开放平台“控制台 > 我的应用 > SDK下载”页面也可完成下载。
下载JAVA SDK以后,解压缩,引用非源码的jar包,创建如下的类,即完成代码调用
OpenClient类为SDK的入口类,其实现类为DefaultOpenClient
RechargeBaseGetItemInfoRequest为API请求参数的封装类
RechargeBaseGetItemInfoResponse为API请求返回结果的封装类
更多API调用示例,请看API文档中的SDK调用示例。
JAVA SDK调用示例:
import com.qianmi.open.api.ApiException; import com.qianmi.open.api.DefaultOpenClient; import com.qianmi.open.api.OpenClient; import com.qianmi.open.api.request.RechargeBaseGetItemInfoRequest; import com.qianmi.open.api.response.RechargeBaseGetItemInfoResponse; public class ApiDemo { protected static String serverUrl = "http://api.bm001.com/api"; protected static String appKey = "test"; protected static String appSecret = "test"; protected static String acceessToken = "test"; public void testGetItemInfo() { OpenClient client = new DefaultOpenClient(serverUrl, appKey, appSecret); RechargeBaseGetItemInfoRequest req = new RechargeBaseGetItemInfoRequest(); req.setItemId("140600"); try { RechargeBaseGetItemInfoResponse response=client.execute(req,acceessToken); System.out.println(response.getItemInfo().getItemName()); } catch (ApiException e) { e.printStackTrace(); } } public static void main(String[] args) { new ApiDemo().testGetItemInfo(); } }
下载PHP SDK以后,解压缩,直接引用包,创建如下的类,即完成代码调用
OpenClient类为调用SDK的实例化类
ItemGetRequest为API请求参数的封装类
更多API调用示例,请看API文档中的SDK调用示例
PHP SDK调用示例:
<?php /** *力方开放平台 PHP调用示例 *适用于PHP5.1.2及以上版本 */ header("Content-type:text/html; charset=utf-8"); require("OpenSdk.php"); $loader = new QmLoader; $loader -> autoload_path = array(CURRENT_FILE_DIR.DS."client"); $loader -> init(); $loader -> autoload(); $client = new OpenClient; $client -> appKey = "test"; $client -> appSecret = "test"; $accessToken = "test"; $req = new ItemGetRequest; $req -> setFields("title,price"); $req -> setNumIid("p17080"); $res = $client -> execute($req, $accessToken); print_r(json_encode($res)); ?>
下载.NET SDK以后,解压缩,引用DLL文件,创建如下的类,即完成代码调用
IOpenClient类为SDK的入口类,其实现类为DefaultOpenClient
RechargeBaseGetItemInfoRequest为API请求参数的封装类
RechargeBaseGetItemInfoResponse为API请求返回结果的封装类
更多API调用示例,请看API文档中的SDK调用示例
.NET SDK调用示例:
using System; using System.Collections.Generic; using System.Linq; using System.Text; using Qianmi.Api; using Qianmi.Api.Response; using Qianmi.Api.Request; namespace ConsoleApplication { class Program { static void Main() { string serverUrl = "http://api.bm001.com/api"; string appKey = "test"; string appSecret = "test"; string acceessToken = "test"; IOpenClient client = new DefaultOpenClient(serverUrl, appKey, appSecret); RechargeBaseGetItemInfoRequest req = new RechargeBaseGetItemInfoRequest(); req.ItemId = "140600" RechargeBaseGetItemInfoResponse response = client.Execute(req,acceessToken); if (!response.IsError) { Console.WriteLine(response.ItemInfo.ItemName); } } } }
为了让开发者更加快速对接力方开放平台,平台推出了基于JAVA SDK的演示demo,演示demo仅以java接入话费充值类目为示范,包含全部的页面部分及后台代码,其他类目、其他语言类型的不再提供,基本上可以参考此demo。
演示demo包含以下几个功能:采用Maven结构,使用Spring MVC框架。业务逻辑代码在src/main/java/com/qianmi/open/sdk/web/controller里面。配置文件在src/main/resources里面。页面代码在src/main/java/webapp/WEB-INF/pages里面。