EasyAlgerie · 开发者
免费的阿尔及利亚第纳尔 API
为您的网站、应用或 AI 智能体添加第纳尔汇率与货币换算功能。返回简洁的 JSON 数据，无需账户或 API 密钥。
- 无需身份验证
- 11 种货币 ↔ DZD
- 只读访问
发起第一个请求
将此示例复制到终端，即可按照平行市场的参考买入价，将 100 欧元换算为第纳尔。
curl 'https://easyalgerie.com/api/v1/dinar/convert?amount=100&from=EUR&to=DZD&market=parallel_buy'两个端点，统一简洁的格式
基础 URL : https://easyalgerie.com/api/v1/dinar
GET /rates — 获取汇率
汇率以每 1 单位外币对应的 DZD 金额表示。不设置筛选条件时，响应包含全部 11 种支持的外币。
curl 'https://easyalgerie.com/api/v1/dinar/rates?currency=EUR'currency- 可选：外币代码，例如 EUR 或 USD。此处不能使用 DZD。
GET /convert — 换算金额
支持外币兑第纳尔或第纳尔兑外币。两种货币中必须恰好有一种是 DZD；不支持 EUR/USD 等外币之间的直接换算。
amount- 必填。范围为 0 至 1,000,000,000，使用英文小数点，最多 6 位小数。不能包含千位分隔符或使用指数表示法。
from / to- 必填。源货币和目标货币的 ISO 代码，其中必须恰好有一个是 DZD。
market- 可选。official、parallel_buy 或 parallel_sell。默认值为 parallel_buy。
货币代码不区分大小写。不接受未知参数或重复参数。
支持的货币
DZDEURUSDCADGBPCHFTRYCNYSARAEDTNDMAD
选择合适的汇率
official- 来自汇率提供商的银行参考汇率，并非银行保证提供的兑换报价。
parallel_buy- 兑换商向客户买入外币，并支付第纳尔。
parallel_sell- 兑换商向客户卖出外币，并收取第纳尔。
所选市场适用于两个换算方向；API 不会自动切换到另一种汇率。
理解响应数据
result- 换算后的金额，按四舍五入规则保留两位小数。
rate- 换算系数：1 单位 from = rate 单位 to。
dzdPerUnit- 每 1 单位外币对应的 DZD 参考汇率。
provenance- 数值的来源类型、数据来源及可用时间戳。
数据来源与时效性
provider- 从外部提供商获取的汇率。
editorial- 公共换算器的编辑汇率，包括 EasyAlgerie 手动录入的数值。
fallback- 静态备用值。请勿将其描述为当前市场汇率。
通过 sourceUpdatedAt 查看来源时间戳；null 表示未知。对于手动汇率，该值是 UTC 编辑时间，并非独立的市场观测时间。retrievedAt 表示数据快照的获取时间，而非汇率确定时间。
外部数据源缓存 6 小时。手动汇率优先，保存时会使其缓存失效（备用缓存有效期为 30 秒）。refreshIntervalSeconds 仅适用于外部数据源。
换算结果仅供参考，不执行交易，也不保证兑换价格。公共汇率与 EasyAlgerie 支付所用的商业汇率相互独立。
限制与错误处理
每个 IP 地址每分钟最多 60 次请求，/rates 与 /convert 共享配额。RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset 响应头提供配额信息。重复计算时建议缓存汇率。
400- 参数无效：请查看 error.code、error.message 和 error.field。
405- 不允许使用此请求方法。请使用 GET 读取数据。
429- 已超出配额：请等待 Retry-After 指定的秒数后再试。
503- 数据暂时不可用。请稍后重试，避免快速循环请求。
开放 CORS：允许浏览器调用，无需发送 Cookie 或身份凭据。无需任何秘密 API 密钥。
JavaScript 示例
const url = new URL("https://easyalgerie.com/api/v1/dinar/convert");
url.search = new URLSearchParams({
amount: "100", from: "EUR", to: "DZD", market: "parallel_buy"
}).toString();
const response = await fetch(url, { credentials: "omit" });
if (response.status === 429) {
throw new Error("Retry after " + response.headers.get("Retry-After") + " seconds");
}
const data = await response.json();
if (!response.ok) throw new Error(data.error?.message || "API unavailable");
console.log(data.result, data.to);
console.log(data.provenance);接入 AI 智能体
- 将 OpenAPI 规范导入兼容工具，并将身份验证设为无。并非所有智能体都支持自动导入。
- 使用 getDinarExchangeRates 获取汇率，使用 convertAlgerianDinars 进行换算。请明确指定所选市场。
- 回复用户前请核对来源与时间戳。不要将编辑汇率或备用值称为实时市场汇率。
- 请澄清有歧义的金额：1 DZD = 100 生丁。如果用户说“几百万”，请询问其指的是第纳尔还是生丁。