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

توثيق API

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

البدء

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

BASE URL

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

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

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

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

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

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

المصادقة

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

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

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

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

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

/client/*

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

نقاط النهاية

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 },
    { "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[].currency

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

rates[].mid

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

rates[].buy

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

rates[].sell

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

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

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

حدود المعدل

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

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

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

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

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

HTTP

X-Rate-Limit-Limit: 5
X-Rate-Limit-Remaining: 3
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: sha256=<hex-digest>
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, 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