开发规范

 

通信协议：

api调用的通信协议为http协议（支持Https），请求方式为Post方法。
请求参数必须以UTF-8编码进行URLEncode，不管是URL后面的数据，还是post body中的数据，都必须以UTF-8编码进行URLEncode。

参数传递规则：

1、系统参数以key1=value1&key2=value2的形式，拼接在URL后面。
例如：https://pinzhi.didichuxing.com/kop_stable/gateway?api=customer.grant.voucher&apiVersion=1.0.0&appKey=12as89asd898asd565as012asd

2、业务参数封装在json结构体里，作为https request body。例如： {“customerKey “:”zhongxinyinhang”,”batchId”:”1” ,” activityId”:”1” ,” phone”:”187”}

注意：两类参数必须以UTF-8编码进行URLEncode。

技术要求：

滴滴代驾商户开放平台是一个为商户提供接入滴滴服务的平台。基于此，在对接平台时需要注意以下技术要求：

1、调用滴滴代驾H5页面时，需要前端使用"window.location.href=url"的方式跳转（其中，测试环境url为"pinzhi-sp.didichuxing.com/m/djhome.node?..." 线上环境的url为"dj.kuaidadi.com/m/djhome.node?..."）。

2、关于回调接口，由于回调接口是面向所有商家的一个统一的回调接口，支持Http和Https两种方式。 但是使用Https方式的证书时，请第三方使用官方机构颁发的证书，避免出现接入问题。

3、关于接口参数中的地图坐标，要求所以地图坐标必须通过高德地图api生成，否者无法成功调用相关接口。

环境信息:

1、测试环境说明
API调用URL: https://pinzhi.didichuxing.com/kop_stable/gateway
H5接入URL : https://pinzhi-sp.didichuxing.com/m/djhome.node
测试环境对外出口ip : 183.157.161.234

2、线上环境说明
API调用URL: https://business.kuaidadi.com/gateway
H5接入URL : https://dj.kuaidadi.com/m/djhome.node
线上环境对外出口ip : 123.207.208.128/25（一个网段）

H5链接拼接说明：

滴滴代驾H5链接拼接格式："滴滴H5地址 + ? + 请求参数拼接字符串"。
以测试环境为例，以下是拼接后的H5链接：
https://pinzhi-sp.didichuxing.com/m/djhome.node?daijia_pid=xxx&daijia_token=xxx&lat=xxx&lng=xxx&mob=xxx&c=xxx&sc=xxx
请求参数拼接字符串：daijia_pid=xxx&daijia_token=xxx&lat=xxx&lng=xxx&mob=xxx&c=xxx&sc=xxx。
参数说明：