实时汇率Api接口你知道多少?

227 阅读6分钟

汇率,经济全球化中的神经中枢,没有深入其中,很难掌握其奥妙,然而,跨国贸易是各个国家之间的经济联系的必然纽带,不同货币之间的流通就需要通过汇率来解决。不同货币的换算就是汇率。

汇率,对跨国贸易产生了极大的影响,因此,汇率的换算就显得尤其重要。汇率换算的方式有多种,比较通用的方式就是接入汇率换算api接口。

汇率API的解释

什么是汇率api接口?它又有些什么样的作用与功能呢?接下来挖数据就来给大家分享汇率API接口的基本功能。

简而言之,API 是一组软件代码和定义,允许两个或多个应用程序相互交互和通信。

我们每天都在使用API,甚至都没有意识到。如果没有API,就不可能在一部设备查看所有银行账户,无论是哪个金融机构提供的服务;我们跨境电商时就不会体验到顺畅的体验——与相关支付提供商无缝连接,输入卡详细信息并完成订单。

  汇率换算api接口是应用程序编程接口的一种,通过汇率API接口,就能使程序获得查询汇率换算信息的相关功能。这个数据接口最大的优点,就在于可以在较短的时间内对不同货币的汇率进行换算。众所周知,货币的汇率处于不断波动的一种状态,影响汇率变动的因素有很多,主要分为市场因素、政府调控和经济发展状况等几种,当这些因素发生变化的时候,汇率就会产生变动。而这些因素总是在不断的变化,尤其是市场因素,几乎是无时无刻不在变动,所以汇率的波动也是无时无刻不在发生的,所以,挖数据平台推出实时汇率API接口,让人们及时掌握汇率变化而不至于造成损失。

实时汇率API接口简介:

提供的数据供参数,与人民币的兑换汇率,单位是100元;每分钟更新一次。具体汇率以办理业务时的实时汇率为准。

Api文档

子接口

  • 招商银行实时汇率查询
  • 中国银行实时汇率查询
  • 工商银行实时汇率查询
  • 光大银行实时汇率查询
  • 交通银行实时汇率查询
  • 农业银行实时汇率查询

返回格式:json,xml

请求方式:GET,POST

POST 请求需要设置Header头:Content-Type: application/x-www-form-urlencoded;charset=utf-8

请求说明:

名称必填类型说明示例 参数另存
appidString应用ID,在后台我的应用查看或者添加1
formatString返回数据格式类型,每个接口已经说明支持返回格式:json,xmljson
signString1.使用Md5方式验证,参数按一定规则md5后返回的字符串,详情点击这里阅读 2.使用Hash验证方式,直接跟上密钥即可。 通过我的应用里面修改验证方式52a9dbe274a5c537bbf7a53e2d66c09f
timeString请求时传递的当前服务器时间戳1545829466

返回参数说明:

名称必填类型说明示例 参数另存
ZCcyNbrString币种类别瑞士法郎
ZRatTimString当前时间09:10:34
ZRtbBidString中行折算价719.37
ZRtcBidString现钞买入价693.83
ZRtcOfrString现钞卖出价722.25
ZRthBidString现汇买入价716.49
ZRthOfrString现汇卖出价722.25
codeidInteger状态码,返回10000状态都会进行计费。具体说明可查看状态码说明10000
messageString请求状态说明操作成功!
retdataArray回数据集合,可能是数据、对象或者字符串

状态码说明:

状态码说明
10000返回成功
10001appid必须指定,可以我的应用里面查看
10002sign值必须指定,加密规则请前往帮助中心查看
10003sign值验证不通过,加密规则请前往帮助中心查看
10004时差不能超过10分钟,可以不传递这个参数,注意时间戳单位是秒
10005appid错误,请检查appid值,前往会员中心->我的应用查看或添加
10006当前IP地址未授权,请前往用户中心->我的应用添加ip{@info}
10007应用被禁用,请联系客服处理
10008应用内没有该接口,请到我的应用里面添加这个接口
10009api接口不存在
10010您没有添加该api接口
10011api已经到期
10012没有订购任何api,请前往购买后再操作
10013该接口已经暂停使用
10014未知的错误,可以联系客服处理
10015参数个数错误
10019{@info}
10017time必须是整型
10018次数不足
10020子接口不存在,可能已经被关闭
10021服务器发生错误
10022帐户余额不足,请充值!
10023订单提交成功,等待回调结果
10024调试模式数据
10025查无数据

请求示例:

$method = 'GET'; //请求方式 GET,POST
$secretType = 'MD5'; //验证方式MD5,Hash 通过后台 我的应用去修改
$api_url = 'https://登录后显示/pyi/75/188';
$appid  =   '应用id';// 在后台我的应用查看;
$secret =   '应用密钥';// 在后台我的应用查看;
$data = array(
    'appid'=>  '1',
    'format'=>  'json',
    'time'=>  '1545829466',
    );

$data['appid'] = $appid;
$data['time'] = time();//当前服务器时间

if('MD5' == $secretType){
    ksort($data); //按照键名对数组排序,为数组值保留原来的键。
    $md5String = '';
    foreach($data as $key=>$val){
        if(strlen($val)>0){ //过滤空值
            $md5String.=$key.$val;
        }
    }
    $secret = md5($md5String.$secret);
}
$data['sign'] = $secret;
if('GET'==$method){
    $sendUrl = $api_url.'?'.http_build_query($data); //把数据转换成url参数形式,a=b&c=d&e=f
    $result = file_get_contents($sendUrl);
}else{
    $header = ['Content-Type: application/x-www-form-urlencoded;charset=utf-8'];
    $ch = curl_init();
    if(is_array($data))$data = http_build_query($data);
    curl_setopt($ch, CURLOPT_URL, $api_url);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    curl_setopt($ch, CURLOPT_POST, true);//POST
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_AUTOREFERER, true);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
    curl_setopt($ch, CURLOPT_ENCODING,'gzip,deflate');
    $result = curl_exec($ch);
}
$result = json_decode($result,true);
print_r($result);

                        

请求参数:

参数名必填类型说明参考值/默认值
appidString应用ID,在后台我的应用查看或者添加1
formatString返回数据格式类型,每个接口已经说明支持返回格式:json,xmljson
signString1.使用Md5方式验证,参数按一定规则md5后返回的字符串,详情点击这里阅读 2.使用Hash验证方式,直接跟上密钥即可。 通过我的应用里面修改验证方式52a9dbe274a5c537bbf7a53e2d66c09f
timeString请求时传递的当前服务器时间戳1545829466