php滴滴平台接口,滴滴API请求SDK

滴滴API请求SDK

为保障请求参数的安全性，滴滴对请求参数进行签名验证处理。该签名值在调用滴滴接口时，作为请求参数传入，滴滴后台会校验签名的正确性。

为简化请求调用，滴滴提供API请求SDK。利用SDK发起对滴滴API的请求，将自动完成参数签名过程。接入的开发者，只需要关注请求参数即可，无须关注签名过程。

SDK获取

开发语言

资源下载

环境要求

Java版SDK说明

SDK包内容

open-sdk-xxxx.jar---------滴滴SDK编译文件jar

fastjson-xxxx.jar---------SDK依赖的json工具jar

log4j-xxxx.jar---------SDK依赖的日志jar

httpclient-xxxx.jar---------SDK依赖的http工具jar

httpcore-xxxx.jar---------SDK依赖的http工具jar

commons-logging-xxxx.jar---------http工具依赖的日志jar

README.md---------SDK说明文件

SDK使用说明

下载SDK，解压后将SDK中的jar包集成到开发项目中。依赖的jar也可以用maven方式引入，pom内容请参考SDK中的README.md。

获取系统参数：利用SDK中的工具类：DidiBizUtil获取(方法名为getSysParams)。

根据具体请求接口，组装请求参数，并调用SDK中的工具HttpUtil.post发送请求即可。

注意

使用sdk时注意根据接入环境修改接入信息(请求url、appKey、appSecret等)。

sdk中使用fastjson解析返回的json信息，实际使用中开放人员可以自行决定json处理工具。

API请求调用示例

//测试环境URL

String url = "https://pinzhi.didichuxing.com/kop_stable/gateway";

//接入应用KEY

String appKey = "1234ff1234AA12345b24dbc71026daaa";

//接入应用证书

String appSecret = "abcdff1234AA12345b24dbc71026d123";

private void post(String appkey, String appSecret) {

/*设置请求参数*/

Map< String, Object> bizParams = new HashMap< String, Object>();

bizParams.put("phone", "12345678901");

bizParams.put("source", "12");

bizParams.put("customerKey", "test==");

bizParams.put("privilegeId", "122345");

bizParams.put("outerOrderId", "121");

/*设置系统参数，此处测试免登接口*/

Map< String, Object> sysParams = DidiBizUtil.getSysParams("test", appkey,"lj.u.p.loginByTp", "1.0.0");

/*发送post请求*/

String resp = HttpUtil.post(url, bizParams, sysParams, appSecret);

System.out.println(resp);

/*获取请求返回json*/

DidiResult result = JSON.parseObject(resp, DidiResult.class);

LoginResultBean loginResult = JSON.parseObject(result.getData().toString(), LoginResultBean.class);

}

public void sdkTest() {

/*测试免登接口*/

post(appKey, appSecret);

}

PHP版SDK说明

SDK包内容

KopUtil.php---------滴滴接入请求相关工具，包括签名和post请求

DidiBizUtil.php---------滴滴接入获取系统参数相关工具

version.txt---------版本信息说明文件

SDK使用说明

下载SDK，解压后将SDK中的php文件集成到开发项目中。

获取系统参数：利用SDK中的工具类：DidiBizUtil获取(方法名为_genPlatParams)。

根据具体请求接口，组装请求参数，并利用KopUtil的_request方法发送请求即可。

API请求调用示例

private $appkey;

private $appSecret;

//初始化配置数据

public function _init() {

$this->appkey = '53439451a6ad4a0dae1e6c55959777d5';

$this->appSecret = 'cd32050edcec4158a87ee5c04ca6ed0f';

}

//免登接口测试

public function _login() {

$aBizParams['phone'] = '12345678901';

$aBizParams['source'] = '12';

$aBizParams['customerKey'] = '1234==';

$aBizParams['privilegeId'] = '12234';

$aBizParams['outerOrderId'] = '121';

$didiBizUtil = new DidiBizUtil();

$aPlatParams = $didiBizUtil->_genPlatParams('test', $this->appkey, 'lj.u.p.loginByTp', '1.0.0');

$kopUtil = new KopUtil();

$result = $kopUtil->_request($aPlatParams, $aBizParams, $this->appSecret);echo $result;

}

//测试登录接口

$kopUtilTest = new KopUtilTest();

$kopUtilTest->_login();

node版SDK说明

SDK包内容

demo.js---------SDK入口，测试demo

index.js---------SDK工具集入口

config.json---------系统参数配置json

lib/kop.js---------接口请求工具(包含接口调用和算签工具)

lib/util.js---------工具集

lib/env.js---------环境控制工具

README.md---------SDK说明文件

SDK使用说明

下载SDK，解压后将SDK中的js库和json文件集成到开发项目中。

系统参数配置：修改config.json文件，根据当前使用环境(线上或测试环境)配置appKey、appSec及kopHost。

开放接口调用程序：参照demo.js或下方"请求调用示例"，配置接口调用系统参数和请求参数，然后调用kop.js的send接口发送请求即可。

API请求调用示例

var kopTools = require('./lib/kop'),

KOP = new kopTools();

//登录参数信息

var params = {

did: 123,

token: "test"

}

//免登接口调用示例

var loginbyTpConfig = {

api:"lj.nbs.u.loginbyTp", // 接口名

apiVersion:"1.0.0",

param:{

phone:123,

source:12,

customerKey:"test",

privilegeId:123

}, // 接口传参

/*login: { // 用户登录信息，需要登录的接口必须传的参数

userRole: 1, // 根据具体的userRole来

userId: params.did, // 用户userid

token: params.token // 用户token

}, */

callback: function(data){ // 成功回调

console.log('getinfo::data=====', data);

params.did = data.pid;

params.token = data.token;

},

errback: function(err, msg){ // 失败回调

console.log('getinfo::data=====', err, msg);

}

}

KOP.send(loginbyTpConfig); // 调用kop