واجهة API مجانية للدينار الجزائري

طلبك الأول

انسخ هذا المثال إلى الطرفية لتحويل 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 — الاطلاع على أسعار الصرف

تُعرض الأسعار بالدينار الجزائري لكل وحدة واحدة من العملة الأجنبية. عند عدم تحديد عملة، تتضمن الاستجابة العملات الـ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

مصدر البيانات ومدى حداثتها

provider

سعر وارد من مزوّد خارجي.

editorial

سعر تحريري للمحوّل العام، بما في ذلك القيم التي تدخلها EasyAlgerie يدويًا.

fallback

قيمة احتياطية ثابتة. لا تعرضها كسعر سوق حالي.

راجع sourceUpdatedAt لمعرفة تاريخ المصدر؛ تعني null أن التاريخ غير معروف. في الأسعار اليدوية، هذا تاريخ التعديل بتوقيت UTC وليس رصدًا مستقلاً للسوق. يشير retrievedAt إلى جلب نسخة البيانات، وليس إلى وقت تحديد السعر.

تُخزّن المصادر الخارجية مؤقتًا لمدة 6 ساعات. للأسعار اليدوية الأولوية، ويُلغى تخزينها المؤقت عند الحفظ (مدة احتياطية: 30 ثانية). يخص refreshIntervalSeconds المصادر الخارجية.

التحويلات استرشادية، ولا تنفّذ معاملات أو تضمن سعر صرف. الأسعار العامة منفصلة عن الأسعار التجارية المستخدمة في مدفوعات EasyAlgerie.

الحدود ومعالجة الأخطاء

60 طلبًا في الدقيقة لكل عنوان IP، مشتركة بين /rates و/convert. توضّح الترويسات RateLimit-Limit وRateLimit-Remaining وRateLimit-Reset الحصة المتاحة. خزّن الأسعار مؤقتًا للحسابات المتكررة.

400

معاملات غير صالحة: راجع error.code وerror.message وerror.field.

405

طريقة غير مسموح بها. استخدم GET لقراءة البيانات.

429

تجاوز الحصة: انتظر عدد الثواني المحدد في Retry-After.

503

البيانات غير متاحة مؤقتًا. حاول لاحقًا دون تكرار سريع للطلبات.

CORS عام: يُسمح بالطلبات من المتصفح دون إرسال ملفات ارتباط أو بيانات اعتماد. لا يلزم أي مفتاح 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);

ربط وكيل ذكاء اصطناعي

1. استورد مواصفات OpenAPI في أداة متوافقة، دون مصادقة. لا تدعم جميع الوكلاء الاستيراد التلقائي.
2. استخدم getDinarExchangeRates لقراءة الأسعار وconvertAlgerianDinars للتحويل. حدّد السوق المختار صراحةً.
3. تحقق من المصدر والتاريخ قبل الإجابة. لا تعرض الأسعار التحريرية أو الاحتياطية كأسعار سوق آنية.
4. وضّح المبالغ الملتبسة: 1 DZD = 100 سنتيم. إذا ذكر العميل «ملايين»، اسأله هل يقصد الدينار أم السنتيم.