API ی گەشەپێدەر

فێربوونی API

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

دەستپێک

URL بنەڕەتی

BASE URL

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

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

نقەکانی گشتی بەخۆڕایانە و بەبێ هیچ ئەکاونت یان مفتاحی API دەستپێگەیشتنیان پێیانە. تا 300 داوا/مانگ بۆ هەر IP.

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

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

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

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

rates[].buy

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

rates[].sell

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

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

لادانی دڕاوی دەستی بووە

سنووری نرخ

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

پاڵپشتی

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