Currency exchange API

A lightweight, modular, and secure backend API for performing real-time currency conversions using external data providers such as Fixer / APILayer. Built with Python, designed for clarity, scalability, and production-ready structure.

原始信息汇总

Currency Exchange API 数据集概述

基本信息

• 数据集名称: Currency Exchange API
• 类别: Financial
• 提供者: Ian Mukuna
• 订阅者数量: 1
• 访问权限: Free
• 当前版本: 1.0.0

数据集描述

一个轻量级、模块化且安全的后端API，用于使用外部数据提供商（如Fixer / APILayer）执行实时货币兑换。使用Python构建，设计注重清晰度、可扩展性和生产就绪结构。

主要功能

• 实时货币兑换
• 使用.env变量进行安全的API密钥处理
• 外部API集成（Fixer / APILayer）
• 自定义ExchangeRateProvider类
• 稳健的错误处理（401未授权、密钥缺失等）
• 清晰的后端架构
• 兼容Django/Django REST框架的结构
• 包含在.gitignore中的API密钥保护

项目结构

project/ │── exchange/ │ ├── provider.py # 包含ExchangeRateProvider类 │ ├── views.py # API端点逻辑 │ ├── urls.py # 转换端点的URL路由 │── .env # 环境变量（未提交） │── .gitignore # 确保忽略.env │── requirements.txt # Python依赖项 │── README.md # 项目文档

API端点

• 默认端点: GET
• 历史端点: GET
• 转换端点: GET
• 汇率端点: GET

货币转换端点示例

• 请求: GET /convert?from=USD&to=KES&amount=100
• 响应示例: json { "success": true, "from": "USD", "to": "KES", "amount": 100, "rate": 153.45, "converted_amount": 15345 }

错误处理

错误类型	示例
缺失API密钥	401: missing_access_key
未授权密钥	401: invalid_access_key
无效货币	400: invalid_currency_code
提供商故障	500: provider_error

环境设置

1. 克隆仓库: git clone https://github.com/yourname/currency-exchange-api.git
2. 创建虚拟环境: python3 -m venv venv
3. 安装依赖: pip install -r requirements.txt
4. 创建.env文件: 包含EXCHANGE_API_KEY和PROVIDER_URL变量

测试方法

使用Postman、Insomnia或浏览器查询：http://127.0.0.1:8000/convert?from=USD&to=KES&amount=100

未来增强计划

• 添加缓存（Redis）
• 添加汇率历史端点
• Docker化项目
• 添加身份验证（JWT）
• 添加前端仪表板

贡献方式

欢迎拉取请求！可以分叉此仓库并就建议提出问题。