واجهة المطوّرين

توثيق API

استخدم API العام الخاص بنا للحصول على بيانات أسعار صرف الليرة السورية في الوقت الفعلي

البدء

عنوان URL الأساسي

BASE URL

https://lirascope.syria-cloud.sy/api/v1

وصول مجاني إلى API

نقاط النهاية العامة متاحة مجاناً دون حساب أو مفتاح API، بحد 60 طلباً في الدقيقة و1200 طلب في الساعة لكل عنوان IP.

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

ملفات جاهزة للقراءة الآلية تتيح لوكلاء الذكاء الاصطناعي وأدوات المطورين فهم واجهة LiraScope البرمجية بسرعة.

مرجع API بصيغة Markdown/api-docs.mdدليل المهارات لوكلاء الذكاء الاصطناعي/SKILLS.mdفهرس llms.txt للوكلاء/llms.txt

المصادقة

API عام ولا يتطلب مصادقة للنقاط العامة

بدون مصادقةنقاط النهاية العامة

/rates/*
/crypto/*
/gold/*
/pricing

60 طلباً/دقيقة و1200 طلب/ساعة لكل عنوان IP

مفتاح API مطلوبنقاط النهاية الخاصة

/client/*

مفاتيح API توفر حصة شهرية وويب هوك وتعفي الطلبات الموثقة من حد عنوان IP المشترك.

نقاط النهاية

GET/rates/latest

الحصول على أحدث الأسعار

احصل على أحدث أسعار الصرف من المصرف المركزي والسوق السوداء

معاملات الاستعلام

currenciesاختياري

قائمة العملات مفصولة بفواصل (مثل USD,EUR)

langاختياري

رمز اللغة (ar, en, de) - الافتراضي: ar

مثال على الطلب

cURL

curl "https://lirascope.syria-cloud.sy/api/v1/rates/latest?currencies=USD,EUR&lang=ar"

مثال على الاستجابة

JSON

{
  "disclaimer": "...",
  "timestampUtc": "2026-01-29T02:00:00Z",
  "cbsRates": [
    {
      "currency": "USD",
      "buy": 110.00,
      "sell": 111.00,
      "mid": 110.50,
      "timestampUtc": "2026-01-29T01:59:47Z",
      "isManualOverride": false
    }
  ],
  "marketRates": [
    {
      "currency": "USD",
      "buy": 116.80,
      "sell": 117.50,
      "mid": 117.15,
      "timestampUtc": "2026-01-29T01:54:46Z",
      "isManualOverride": false
    },
    {
      "currency": "EUR",
      "buy": 138.40,
      "sell": 140.30,
      "mid": 139.35,
      "timestampUtc": "2026-01-29T01:54:46Z",
      "isManualOverride": false
    }
  ],
  "effectiveRates": [...]
}

GET/rates/usd-based

الحصول على الأسعار بالدولار

الحصول على أحدث أسعار الصرف بالنسبة للدولار الأمريكي

معاملات الاستعلام

langاختياري

رمز اللغة (ar, en, de) - الافتراضي: ar

مثال على الطلب

cURL

curl "https://lirascope.syria-cloud.sy/api/v1/rates/usd-based?lang=ar"

مثال على الاستجابة

JSON

{
  "disclaimer": "...",
  "base": "USD",
  "date": "2026-03-10",
  "timestampUtc": "2026-03-10T12:00:00Z",
  "rates": [
    { "currency": "AED", "buy": 3.6594, "sell": 3.6814, "mid": 3.6704, "timestampUtc": "2026-03-10T11:59:00Z" },
    { "currency": "CHF", "buy": 0.8798, "sell": 0.8851, "mid": 0.8824, "timestampUtc": "2026-03-10T11:59:00Z" },
    { "currency": "EGP", "buy": 49.721, "sell": 50.019, "mid": 49.870, "timestampUtc": "2026-03-10T11:59:00Z" },
    { "currency": "EUR", "buy": 0.9174, "sell": 0.9229, "mid": 0.9201, "timestampUtc": "2026-03-10T11:59:00Z" },
    { "currency": "GBP", "buy": 0.7820, "sell": 0.7867, "mid": 0.7843, "timestampUtc": "2026-03-10T11:59:00Z" },
    { "currency": "KWD", "buy": 0.3066, "sell": 0.3085, "mid": 0.3075, "timestampUtc": "2026-03-10T11:59:00Z" },
    { "currency": "SAR", "buy": 3.7477, "sell": 3.7702, "mid": 3.7590, "timestampUtc": "2026-03-10T11:59:00Z" },
    { "currency": "TRY", "buy": 43.945, "sell": 44.209, "mid": 44.077, "timestampUtc": "2026-03-10T11:59:00Z" }
  ]
}

حقول الاستجابة

base

العملة الأساسية (USD)

date

تاريخ آخر تحديث للسعر

rates[].currency

رمز العملة وفق ISO 4217 (مثل EUR، GBP)

rates[].mid

السعر الوسطي (المرجعي) — 1 دولار = X وحدة

rates[].buy

سعر الشراء المشتق من بيانات السوق

rates[].sell

سعر البيع المشتق من بيانات السوق

rates[].timestampUtc

وقت التحديث

GET/crypto/latest

أحدث أسعار العملات الرقمية

احصل على أحدث أسعار العملات الرقمية بالدولار الأمريكي مع بيانات التغيّر خلال 24 ساعة.

معاملات الاستعلام

langاختياري

لغة الاستجابة (ar، en، de)

مثال على الطلب

cURL

curl "https://lirascope.syria-cloud.sy/api/v1/crypto/latest?lang=ar"

GET/gold/latest

أحدث أسعار الذهب

احصل على أحدث أسعار الذهب بالدولار الأمريكي مع بيانات التغيّر خلال 24 ساعة.

معاملات الاستعلام

langاختياري

لغة الاستجابة (ar، en، de)

مثال على الطلب

cURL

curl "https://lirascope.syria-cloud.sy/api/v1/gold/latest?lang=ar"

حقول الاستجابة

disclaimer

رسالة إخلاء المسؤولية (مترجمة)

timestampUtc

الطابع الزمني UTC

cbsRates

أسعار المصرف المركزي

marketRates

أسعار السوق

effectiveRates

الأسعار الفعالة (تجاوزات يدوية أو سوق)

[].currency

رمز العملة

[].buy

سعر الشراء

[].sell

سعر البيع

[].mid

السعر الوسطي

[].timestampUtc

وقت التحديث

[].isManualOverride

ما إذا كان سعراً يدوياً

حدود المعدل

الطلبات العامة محدودة حسب عنوان IP. الطلبات الموثقة محدودة بـ60 طلباً في الدقيقة لكل مفتاح إضافةً إلى حصة الباقة الشهرية.

الباقة	المصادقة	شهرياً	في الدقيقة	في الساعة
المجاني (IP)	بدون مصادقة	—	60 / IP	1,200 / IP
مجاني	مفتاح API مطلوب	300	60 / key	—
المبدئي	مفتاح API مطلوب	10,000	60 / key	—
الاحترافي	مفتاح API مطلوب	500,000	60 / key	—
المؤسسي	مفتاح API مطلوب	غير محدود	60 / key	—

الباقات المدفوعة ترفع الحصة الشهرية وعدد الويب هوك. عرض الباقات

ترويسات حدود المعدل

تتضمن جميع استجابات API معلومات حدود المعدل:

HTTP

X-Rate-Limit-Limit: 60
X-Rate-Limit-Remaining: 58
X-Rate-Limit-Reset: 2026-02-04T10:15:00Z

استجابة HTTP 429

عند تجاوز حد المعدل:

JSON

{
  "error": "Rate limit exceeded. Please retry after 45 seconds.",
  "retryAfter": 45
}

API الخاص و Webhooks

يتيح لك API الخاص إنشاء تكاملات مع تنبيهات أسعار الصرف عبر Webhooks موقعة.

مصادقة API الخاص

تتطلب جميع نقاط /client/* مفتاحاً عاماً ومفتاحاً خاصاً في ترويسات الطلب.

X-Api-Key

مفتاحك العام (lsp_pub_...)

X-Api-Secret

مفتاحك الخاص (lsp_prv_...)

cURL

curl -X GET https://lirascope.syria-cloud.sy/api/v1/client/me \
  -H "X-Api-Key: lsp_pub_a1b2c3..." \
  -H "X-Api-Secret: lsp_prv_d4e5f6..."

يتم عرض المفتاح الخاص مرة واحدة فقط عند الإنشاء. احفظه فوراً في مكان آمن.

GET/client/me

الملف الشخصي للعميل

اعرض معلومات حسابك وعدد Webhooks المسجلة.

مثال على الاستجابة

JSON

{
  "id": "3fa85f64-...",
  "name": "My Integration",
  "publicKey": "lsp_pub_a1b2c3...",
  "isActive": true,
  "createdUtc": "2026-03-08T00:00:00Z",
  "lastUsedUtc": "2026-03-08T12:00:00Z",
  "webhookCount": 2
}

Webhooks

سجّل عناوين URL لاستقبال تنبيهات تلقائية عند تحقق شروط الأسعار.

GET/client/webhooks— عرض جميع Webhooks

POST/client/webhooks— إنشاء Webhook جديد

PUT/client/webhooks/{id}— تحديث Webhook

DELETE/client/webhooks/{id}— حذف Webhook

مثال على الطلب

cURL

curl -X POST https://lirascope.syria-cloud.sy/api/v1/client/webhooks \
  -H "X-Api-Key: lsp_pub_a1b2c3..." \
  -H "X-Api-Secret: lsp_prv_d4e5f6..." \
  -H "Content-Type: application/json" \
  -d '{
    "webhookUrl": "https://my-server.com/hooks/rate-alert",
    "currency": "USD",
    "source": "MARKET",
    "alertType": 0,
    "thresholdValue": 15000.0,
    "label": "USD high alert"
  }'

أنواع التنبيهات

0 — ABOVE

تنبيه عندما يكون السعر ≥ الحد

1 — BELOW

تنبيه عندما يكون السعر ≤ الحد

2 — CHANGE_INCREASE

تنبيه عند ارتفاع السعر بنسبة %

3 — CHANGE_DECREASE

تنبيه عند انخفاض السعر بنسبة %

حمولة Webhook

عند تحقق شرط التنبيه، يرسل LiraScope طلب POST إلى عنوان Webhook الخاص بك.

الترويسات

HTTP

Content-Type: application/json
X-LiraScope-Signature-Version: 2
X-LiraScope-Timestamp: <unix-seconds>
X-LiraScope-Signature-256: <hex-hmac>
X-LiraScope-Event: rate_alert

مثال على الاستجابة

JSON

{
  "event": "rate_alert",
  "currency": "USD",
  "source": "MARKET",
  "alertType": "ABOVE",
  "threshold": 15000.0,
  "currentRate": 15250.0,
  "previousRate": 14800.0,
  "label": "USD high alert",
  "webhookId": "7c9e6679-...",
  "timestampUtc": "2026-03-08T12:30:00Z"
}

التحقق من التوقيع

تحقق من HMAC-SHA256 باستخدام سر التوقيع الذي يظهر مرة واحدة، ووقّع الطابع الزمني.النص الخام وارفض طابعاً أقدم من خمس دقائق.

Node.js

const crypto = require('crypto');

function verifySignature(body, timestamp, received, signingSecret) {
  if (Math.abs(Math.floor(Date.now() / 1000) - Number(timestamp)) > 300) return false;
  const expected = crypto.createHmac('sha256', signingSecret)
    .update(timestamp + '.' + body).digest('hex');
  const a = Buffer.from(expected, 'hex');
  const b = Buffer.from(received, 'hex');
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

موثوقية Webhook

يتم تعطيل Webhooks تلقائياً بعد 10 محاولات فاشلة متتالية.
يمكنك إعادة تفعيل Webhook عبر لوحة التحكم أو نقطة PUT.
تعرض حقول lastDeliveryStatusCode و consecutiveFailures حالة التسليم.

التكاملات

استخدم LiraScope في ووردبريس وWHMCS أو أنشئ بطاقة أسعار قابلة للتضمين.

ليراسكوب لووردبريس

أضف أسعار الليرة السورية الرسمية وأسعار السوق، وجداول الفجوة، والرسوم البيانية، والمحوّلات، والمكوّنات، والودجات، والتصدير، وتغذية أسعار WooCommerce.

عرضه على WordPress.org تنزيل الإصدار 1.0.0

LiraScope لنظام WHMCS

اعرض أسعار الليرة السورية الرسمية وأسعار السوق داخل لوحة الإدارة ومنطقة العملاء، وحدّث سعر فوترة SYP عبر تغذية اختيارية محمية وقابلة للتدقيق.

عرض التفاصيل تنزيل الإصدار 1.1.1

منشئ التضمين

اضبط بطاقة أسعار مستضافة لأي موقع من دون تثبيت إضافة.

فتح منشئ التضمين

الدعم

للحصول على الدعم أو الإبلاغ عن المشكلات، يرجى الاتصال بـ info@omarino.de