接口概述
货币汇率换算API是由接口盒子提供的一项免费服务接口，能够实现全球多种货币之间的汇率换算功能。该接口每日更新汇率数据，为开发者提供便捷的货币换算解决方案。
接口特点
- 免费使用：基础功能完全免费
- 每日更新：汇率数据每日自动更新
- 多币种支持：支持全球170多种货币代码
- 简单易用：请求参数简洁明了，返回数据格式规范
- 无调用上限：每日调用次数无限制
重要说明
需要注意的是，该接口每日只更新一次汇率数据，对于金额较大的换算可能存在一定误差，适合一般参考用途。如需更实时的汇率数据，可联系官方定制接口。
接口基本信息
请求地址：https://cn.apihz.cn/api/jinrong/huilv.php
请求方式：支持GET和POST两种方式
请求参数说明
参数名 |
类型 |
是否必填 |
说明 |
id |
整数 |
是 |
用户中心的数字ID |
key |
字符串 |
是 |
用户中心通讯秘钥 |
from |
字符串 |
否 |
待换算货币代码(如:USD)，为空时返回货币代码大全 |
to |
字符串 |
否 |
欲换算货币代码(如:CNY)，为空时返回货币代码大全 |
money |
数字 |
是 |
待换算金额 |
返回参数说明
参数名 |
说明 |
code |
状态码(200成功，400错误) |
msg |
信息提示 |
uptime |
货币汇率更新时间 |
money |
待换算金额 |
from |
待换算货币代码 |
to |
欲换算货币代码 |
result |
换算后的金额 |
rate |
汇率 |
调用示例
1. 直接调用示例（使用公共ID和KEY）
复制
https://cn.apihz.cn/api/jinrong/huilv.php?id=88888888&key=88888888&from=USD&to=CNY&money=10
2. 成功返回示例
json
json
复制
{ "code": 200, "uptime": "2025-12-20 08:00:01", "money": "1", "from": "USD", "to": "CNY", "result": 7.0511, "rate": 7.0511 }
3. 错误返回示例
json
json
复制
{ "code": 400, "msg": "通讯秘钥错误。" }
4. 获取货币代码大全返回示例
json
json
复制
{ "code": 200, "message": "货币大全", "data": [ { "code": "USD", "name": "美元" }, { "code": "AED", "name": "阿联酋迪拉姆" }, // ...更多货币代码 ] }
编程语言调用示例
PHP调用示例
php
php
复制
<?php /** * 货币汇率换算API调用示例(PHP版) */ class CurrencyConverter { private $apiUrl = "https://cn.apihz.cn/api/jinrong/huilv.php"; private $userId = "你的用户ID"; // 请替换为实际用户ID private $userKey = "你的用户KEY"; // 请替换为实际用户KEY /** * 执行货币换算 * @param string $from 源货币代码 * @param string $to 目标货币代码 * @param float $amount 换算金额 * @return array 返回结果数组 */ public function convertCurrency($from, $to, $amount) { // 构建请求参数 $params = array( 'id' => $this->userId, 'key' => $this->userKey, 'from' => $from, 'to' => $to, 'money' => $amount ); // 构建请求URL $url = $this->apiUrl . '?' . http_build_query($params); // 发送GET请求 $response = file_get_contents($url); // 解析JSON响应 $result = json_decode($response, true); return $result; } /** * 获取所有支持的货币代码 * @return array 货币代码列表 */ public function getCurrencyList() { // 构建请求参数(不指定from和to参数) $params = array( 'id' => $this->userId, 'key' => $this->userKey, 'money' => 1 ); // 构建请求URL $url = $this->apiUrl . '?' . http_build_query($params); // 发送GET请求 $response = file_get_contents($url); // 解析JSON响应 $result = json_decode($response, true); return $result; } } // 使用示例 $converter = new CurrencyConverter(); // 示例1: 货币换算 echo "=== 货币换算示例 ===\n"; $result = $converter->convertCurrency("USD", "CNY", 100); if ($result['code'] == 200) { echo "换算结果: {$result['money']} {$result['from']} = {$result['result']} {$result['to']}\n"; echo "汇率: 1 {$result['from']} = {$result['rate']} {$result['to']}\n"; echo "更新时间: {$result['uptime']}\n"; } else { echo "错误: {$result['msg']}\n"; } // 示例2: 获取货币列表 echo "\n=== 获取货币列表示例 ===\n"; $currencyList = $converter->getCurrencyList(); if ($currencyList['code'] == 200) { echo "支持的货币数量: " . count($currencyList['data']) . "\n"; // 显示前5种货币作为示例 for ($i = 0; $i < min(5, count($currencyList['data'])); $i++) { $currency = $currencyList['data'][$i]; echo "{$currency['code']}: {$currency['name']}\n"; } } else { echo "错误: {$currencyList['msg']}\n"; } ?>
Python调用示例
python
python
下载
复制
#!/usr/bin/env python3 """ 货币汇率换算API调用示例(Python版) """ import requests import json class CurrencyConverter: def __init__(self, user_id, user_key): self.api_url = "https://cn.apihz.cn/api/jinrong/huilv.php" self.user_id = user_id # 请替换为实际用户ID self.user_key = user_key # 请替换为实际用户KEY def convert_currency(self, from_currency, to_currency, amount): """ 执行货币换算 :param from_currency: 源货币代码 :param to_currency: 目标货币代码 :param amount: 换算金额 :return: 返回结果字典 """ # 构建请求参数 params = { 'id': self.user_id, 'key': self.user_key, 'from': from_currency, 'to': to_currency, 'money': amount } try: # 发送GET请求 response = requests.get(self.api_url, params=params) response.raise_for_status() # 检查请求是否成功 # 解析JSON响应 result = response.json() return result except requests.exceptions.RequestException as e: return {'code': 400, 'msg': f'请求失败: {str(e)}'} except json.JSONDecodeError as e: return {'code': 400, 'msg': f'JSON解析失败: {str(e)}'} def get_currency_list(self): """ 获取所有支持的货币代码 :return: 货币代码列表 """ # 构建请求参数(不指定from和to参数) params = { 'id': self.user_id, 'key': self.user_key, 'money': 1 } try: # 发送GET请求 response = requests.get(self.api_url, params=params) response.raise_for_status() # 检查请求是否成功 # 解析JSON响应 result = response.json() return result except requests.exceptions.RequestException as e: return {'code': 400, 'msg': f'请求失败: {str(e)}'} except json.JSONDecodeError as e: return {'code': 400, 'msg': f'JSON解析失败: {str(e)}'} def main(): # 使用示例 # 注意: 请将下面的用户ID和KEY替换为实际值 converter = CurrencyConverter("你的用户ID", "你的用户KEY") # 示例1: 货币换算 print("=== 货币换算示例 ===") result = converter.convert_currency("USD", "CNY", 100) if result.get('code') == 200: print(f"换算结果: {result['money']} {result['from']} = {result['result']} {result['to']}") print(f"汇率: 1 {result['from']} = {result['rate']} {result['to']}") print(f"更新时间: {result['uptime']}") else: print(f"错误: {result.get('msg', '未知错误')}") # 示例2: 获取货币列表 print("\n=== 获取货币列表示例 ===") currency_list = converter.get_currency_list() if currency_list.get('code') == 200: print(f"支持的货币数量: {len(currency_list['data'])}") # 显示前5种货币作为示例 for i in range(min(5, len(currency_list['data']))): currency = currency_list['data'][i] print(f"{currency['code']}: {currency['name']}") else: print(f"错误: {currency_list.get('msg', '未知错误')}") if __name__ == "__main__": main()
使用前准备
- 注册账号：访问接口盒子官网注册账号
- 获取ID和KEY：登录用户中心获取专属的用户ID和通讯秘钥
- 替换示例代码：将上述示例代码中的"你的用户ID"和"你的用户KEY"替换为实际值
注意事项
- 避免使用公共凭证：示例中的公共ID和KEY有调用频次限制，建议使用个人专属凭证
- 错误处理：在实际应用中应添加完善的错误处理机制
- 汇率时效性：由于汇率每日更新一次，对于时效性要求高的场景请谨慎使用
- 金额精度：金额越大误差可能越大，适合一般参考用途
应用场景
该API接口适用于以下场景：
- 电商平台的多币种价格显示
- 金融应用的汇率查询功能
- 旅行应用的预算换算工具
- 教育类应用的货币知识学习
- 个人理财应用的汇率监控
总结
货币汇率换算API是一个功能完善、使用简单的免费接口，为开发者提供了便捷的货币换算解决方案。通过本文提供的详细说明和代码示例，开发者可以快速集成该功能到自己的应用中。
如需了解更多详情或遇到问题，可访问接口盒子官方网站查看最新文档或联系技术支持。
