卖好车开放平台 - maihaoche/BRZ GitHub Wiki
1、接入方式
商务洽谈完成后,卖好车将以邮件形式,将cropId,cropKey,合作方RSA私钥,卖好车RSA公钥发送给合作方
2、字符集编码
统一使用UTF-8
3、加密、解密、参数传递
调用卖好车开放平台接口时,按照接口文档param的格式序列化为JSON字符串,然后使用卖好车公钥对拼装好的字符串进行加密,使用url safe的Base64对加密的结果进行编码,得到密文的字符串。
对于GET/DELETE接口,请求参数统一采用url?ct=密文方式传递参数。
对于POST/PUT接口,请求参数统一采用JSON格式{"ct":"密文"}传递。
所有接口返回值统一采用 {"code":"","message":"","ct":"密文"} 的格式返回,接收到接口响应结果后,使用合作方私钥进行解密,明文使用UTF-8字符集编码,按照对应接口文档中的param字段进行反序列化。
4、参数签名、验签
调用卖好车开放平台接口时,使用合作方RSA私钥,对请求参数进行签名,对签名后的结果使用url safe的Base64进行编码,得到签名字符串,将签名字符串放置header中,key命名为X-SIGNATURE。
接收到接口响应结果后,从header中获取到X-SIGNATURE签名值,使用卖好车公钥,对响应体中的数据进行验签。
5、域名
线上环境域名: https://open.maihaoche.com
测试环境域名: https://open.haimaiche.net