SDK使用说明 更新时间:2016-01-20 

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下载页面也可完成下载

java

生成时间:2019-05-22
点击下载

java

生成时间:2019-05-22
点击下载

java

生成时间: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

/**
 *千米开放平台 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里面。

更多详情请点击:https://github.com/QMopenteam/java-sdk-demo/blob/master/README.md

demo github地址:https://github.com/QMopenteam/java-sdk-demo