API ی گەشەپێدەر

فێربوونی API

بەکاربهێنە API گشتی ئێمە بۆ دەست کێشان بـ داتای نرخی دەنگی لیرە سوریە بە کاتی ڕاستەوخۆ

دەستپێک

URL بنەڕەتی

BASE URL

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

دەستگەییشتنی ئازادی API

خاڵە گشتییەکان بەبێ هەژمار یان کلیلی API بەخۆڕایین؛ بۆ هەر IP سنوورەکە 60 داواکاری/خولەک و 1200/کاتژمێرە.

سەرچاوەی گەشەپێدەر و بریکارانی AI

فایلی خوێندنەوەی ئامێری کە ڕێگە بە بریکارانی AI و ئامرازی گەشەپێدەران دەدات بە خێرایی API ی LiraScope تێبگەن.

سەرچاوەی API (Markdown)/api-docs.mdڕێنمایی شارەزایی بۆ بریکارانی AI/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=ku"

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

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

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

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

نرخی ناوەڕاست (سەرچاوە) — ١ دۆلار = X یەکە

rates[].buy

نرخی کڕین کە لە داتای بازاڕەوە دەرهێنراوە

rates[].sell

نرخی فرۆشتن کە لە داتای بازاڕەوە دەرهێنراوە

rates[].timestampUtc

کاتی تازەکردنەوە

GET/crypto/latest

نرخە کریپتۆ نوێیەکان

نرخی نوێترینی دراوە کریپتۆکان بە دۆلار لەگەڵ داتای گۆڕانی ٢٤ کاتژمێر بەدەستبهێنە.

پارامەترەکانی داواکاری

langدلخوازکار

زمانی وەڵام (ar، en، de)

نموونەی داواکاری

cURL

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

GET/gold/latest

نرخە زێڕە نوێیەکان

نرخی نوێترینی زێڕ بە دۆلار لەگەڵ داتای گۆڕانی ٢٤ کاتژمێر بەدەستبهێنە.

پارامەترەکانی داواکاری

langدلخوازکار

زمانی وەڵام (ar، en، de)

نموونەی داواکاری

cURL

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

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

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

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

یەکخستنەکان

LiraScope لە WordPress و WHMCS بەکاربهێنە یان کارتی نرخێکی تێخراو دروست بکە.

LiraScope بۆ WordPress

نرخی فەرمی و بازاڕی لیرەی سووریا، خشتەی جیاوازی، هێڵکاری، گۆڕەر، بلۆک، ویجێت، هەناردەکردن و ڕەوتی نرخی WooCommerce زیاد بکە.

لە WordPress.org ببینە وەشانی 1.0.0 دابگرە

LiraScope بۆ WHMCS

نرخی فەرمی و بازاڕی لیرەی سووری لە ناوچەی بەڕێوەبەر و کڕیار پیشان بدە و نرخی پسوولەی SYP بە ڕەوتێکی ئارەزوومەندانە، پارێزراو و وردبینی‌کراو نوێ بکەرەوە.

بینینی وردەکاری داگرتنی وەشانی 1.1.1

دروستکەری تێخستن

کارتی نرخێکی میوانداریکراو بۆ هەر ماڵپەڕێک ڕێکبخە بەبێ دامەزراندنی پڵەگین.

دروستکەری تێخستن بکەرەوە

پاڵپشتی

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