توثيق API

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

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

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

🆓

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

نقاط النهاية العامة متاحة مجاناً دون الحاجة إلى حساب أو مفتاح API. حتى 300 طلب/شهر لكل عنوان IP.

المصادقة

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

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

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

300 طلب/شهر لكل IP — مجاناً تماماً

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

/client/*

اشترك للحصول على حدود أعلى ومزايا متقدمة

نقاط النهاية

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

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

GET/rates/latest

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

currencies(اختياري)

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

lang(اختياري)

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

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

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

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

{
  "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 "https://lirascope.syria-cloud.sy/api/v1/rates/usd-based?lang=ar"

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

{
  "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 },
    { "currency": "CHF", "buy": 0.8798, "sell": 0.8851, "mid": 0.8824 },
    { "currency": "EGP", "buy": 49.721, "sell": 50.019, "mid": 49.870 },
    { "currency": "EUR", "buy": 0.9174, "sell": 0.9229, "mid": 0.9201 },
    { "currency": "GBP", "buy": 0.7820, "sell": 0.7867, "mid": 0.7843 },
    { "currency": "KWD", "buy": 0.3066, "sell": 0.3085, "mid": 0.3075 },
    { "currency": "SAR", "buy": 3.7477, "sell": 3.7702, "mid": 3.7590 },
    { "currency": "TRY", "buy": 43.945, "sell": 44.209, "mid": 44.077 }
  ]
}

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

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

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

rates[].currencyISO 4217 currency code (e.g. EUR, GBP)

rates[].midMid (reference) rate — 1 USD = X units

rates[].buyBuy rate derived from market data

rates[].sellSell rate derived from market data

Latest Crypto Prices

Get the latest cryptocurrency prices in USD with 24h change data.

GET/crypto/latest

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

lang(اختياري)

Response language (ar, en, de)

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

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

Latest Gold Prices

Get the latest gold prices in USD with 24h change data.

GET/gold/latest

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

lang(اختياري)

Response language (ar, en, de)

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

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

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

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

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

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

marketRatesأسعار السوق

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

currencyرمز العملة

buyسعر الشراء

sellسعر البيع

midالسعر الوسطي

timestampUtcوقت التحديث

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

حدود المعدل

لحماية API من سوء الاستخدام، يتم تطبيق حدود المعدل التالية على جميع نقاط النهاية العامة.

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

ترقية إلى خطة مدفوعة للحصول على حدود أعلى. عرض الباقات

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

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

X-Rate-Limit-Limit: 5
X-Rate-Limit-Remaining: 3
X-Rate-Limit-Reset: 2026-02-04T10:15:00Z

استجابة HTTP 429

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

{
  "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 -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..."

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

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

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

GET/client/me

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

{
  "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 جديد

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

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تنبيه عند انخفاض السعر بنسبة %

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

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

حمولة Webhook

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

Headers

Content-Type: application/json
X-LiraScope-Signature: sha256=<hex-digest>
X-LiraScope-Event: rate_alert

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

{
  "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 مع مفتاحك العام كمفتاح سري.

// JavaScript / Node.js
const crypto = require('crypto');

function verifySignature(body, publicKey, signatureHeader) {
  const expected = crypto.createHmac('sha256', publicKey)
    .update(body).digest('hex');
  const received = signatureHeader.replace('sha256=', '');
  return crypto.timingSafeEqual(
    Buffer.from(expected), Buffer.from(received)
  );
}

موثوقية Webhook

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

الدعم

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