SDK版本说明
为了让开发者快捷开发接入,千米开放平台推出了SDK开发包,SDK是由程序自动化生成的代码包,其中包含了开放平台已经开放的API,封装了API调用的请求入入参,签名加密,返回值解析等一些必要的功能,目前开放平台提供的版本如下
java sdk支持1.6及以上
.net sdk支持.net 3.5及以上
php sdk支持php5及以上
下载方法
截止目前,千米开放平台已推出JAVA、PHP以及.NET等版本的SDK。
SDK为新零售API版本,根据自身应用实际情况选择相应语言,相应功能的SDK下载
千米账号登陆开放平台控制台系统,在我的应用-SDK下载页面也可完成下载
仅包含新零售相关业务API
的功能包,请根据需要选择合适语言的SDK。
生成时间:2019-05-22
点击下载
生成时间:2019-05-22
点击下载
生成时间:2019-05-22
点击下载
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://gw.api.qianmi.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调用示例
*适用于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://gw.api.qianmi.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);
}
}
}
}
SDK演示Demo
为了让开发者更加快速对接千米开放平台,平台推出了基于JAVA SDK的演示demo,演示demo仅以java接入话费充值类目为示范,包含全部的页面部分及后台代码,其他类目、其他语言类型的不再提供,基本上可以参考此demo.
演示demo包含以下几个功能:
1:直销商用户授权及授权刷新
2:获取话费充值商品
3:创建话费充值订单
4:使用消息服务获取订单消息及消息处理
项目采用maven结构,使用Spring MVC框架开发。简单起见,所有业务逻辑代码均放在src/main/java/com/qianmi/open/sdk/web/controller里面。项目所需配置文件放在src/main/resources里面。页面代码放在src/main/java/webapp/WEB-INF/pages里面。