فێربوونی 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=ku"

نموونەی وەڵام

{
  "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=ku"

نموونەی وەڵام

{
  "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=ku"

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=ku"

بوارەکانی وەڵام

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 تایبەت ڕێگەت پێدەدات کە تەکنەکاریت بە ئاگاداری Webhook واژوکراو بۆ مەرجەکانی نرخ دروست بکەیت.

ناسپێژاندنی 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 بۆ URL ی 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 جار بەدوای یەکتر شکست دەهێنن خودکار ناچالاک دەکرێن.
لە ڕێگەی داشبۆرد یان نقەی PUT /client/webhooks/{id} دووبارە چالاک بکەرەوە.
خانەکانی lastDeliveryStatusCode و consecutiveFailures باری گەیاندن نیشان دەدەن.

پاڵپشتی

بۆ پاڵپشتی یان رێڵانی کێشەکان، تکایە پەیوەندی بگرە info@omarino.de