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里面。