全国31个省份每日油价查询API接口免费调用

2023-03-02

数脉API

全国31个省份每日油价查询API接口免费调用

一、油价接口名称


今日油价行情


二、接口介绍


油价查询接口根据国家公布的油价,次日更新,可查询全国31个省份的具体油价,根据官方公布的油价数据,次日早7点更新,该接口适用于手机APP,公众号及小程序等。


三、API文档


1、请求地址


url:https://api.shumaidata.com/v10/oil/price_info


请求方式method:get/post


参数:


2、签名算法说明:


服务商分配的appid、当前时间毫秒数timestamp、商户分配的app_security、三者通过&符号拼接成字符串进行md5加密得到。


如:appid=xyzxyzxyz,timestamp=1555378976238,app_security=efcefcefcefcefc;

拼接后的字符串格式:str=appid的值&amptimestamp的值&app_security的值;

拼接后的字符串:str=xyzxyzxyz&1555378976238&efcefcefcefcefc;

加密后得到sign=md5(str)=4e7e1974b79f3656aeaf03f1158f5d5d;


3、正确返回:


{

"msg":"成功",

"success":true,

"code":200,

"data":{

"orderNo":"wcoxp2y04xxljv49kz",//订单号

"next_change_time":"20221025",//下一次油价调整时间

"before_change_time":"20220922",//最近一次油价调整时间

"prov":"浙江",

"p0":{

"price":"7.85",//当前价格

"change_before_price":"8.08",//最近一次价格

"change":"-0.23",//涨跌幅

"change_percent":"-2.847%"//涨跌率

},

"ret_code":0//0:成功,计费其他:失败,不计费

}

}


4、错误返回:


{

"msg":"参数错误",

"success":false,

"code":400,

"data":{}

}


5、返回字段说明:

6、code错误码说明: