| 开发者平台

比比宝开发平台API文档

在开发者调用以下api时,需要传递以下几个公共参数:
app_key: 开发者获得调用api权限时所生成的app_key(可在控制台页面查看)
timestamp: 1970.1.1 7:00:00到现在的秒数
sign: 将"app_secret",app_secret,以及所有参数名(进行字典排序)和参数值(进行utf8转码)拼接成一个字符串,然后进行md5加密所生成的字符串。

例如:app_secret为 abcdefgh123456(可在控制台页面查看)
api调用链接为:http://api.bbbao.com/api/prod_register?gtin=09787544253994&app_key=987654&timestamp=13892346834
所拼接的字符串应该为 "app_secretabcdefgh123456app_key987654gtin09787544253994timestamp1389234834"
sign = md5("app_secretabcdefgh123456app_key987654gtin09787544253994timestamp1389234834");
sign = "9e860fsaf4635tgdheu48fes85u674nb";
最终api调用链接为:http://api.bbbao.com/api/prod_register?gtin=09787544253994&app_key=987654&timestamp=13892346834&sign=9e860fsaf4635tgdheu48fes85u674nb

1、商品比价相关接口

1.1、注册商品GTIN,并获取QCS
地址 http://api.bbbao.com/api/prod_register
方法 GET
参数 * gtin:全球通用贸易商品编号,必选参数
返回 返回JSON数据包括:
* qcs
1.2、获取商品比价进度
地址 http://api.bbbao.com/api/prod_search_progress
方法 GET
参数 * qcs: 使用1.1返回的qcs字符串,必选参数
返回 返回JSON数据包括:
* progress:返回0-1,1表示比价完成
1.3、获取商品比价结果
地址 http://api.bbbao.com/api/prod_results
方法 GET
参数 * qcs: 使用1.1返回的qcs字符串,必选参数
* sort: 返回比价结果排序类型,可选参数,默认为featured;
价格由低到高(localized_price:asc)
价格由高到低(localized_price:desc)
销量由高到底(volume:desc)
销量由低到高(volume:asc)
返钱由低到高(volume:asc)
返钱由高到低(volume:desc)
返回 返回JSON数据包括:
* result_count: 返回比价结果总数
* results数组,每个数组元素包括:
api_url:返回结果详情的api链接
cashback_type:返钱类型(cashback为返钱,point为返比豆)
image_url:商品图片链接
localized_cashback:返钱数量
price:商品售价
name:商品名称
store_name:商家名称
volume:最近成交量