API ya Pêşdebir

Belgeyên API

API-ya me ya giştî ji bo gihîştina daneyên nirxê guhertina lîreya Sûriyeyê di dema rastîn de bikar bînin

Destpêk

URL-ya Bingehîn

BASE URL

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

Gihiştina API-ya Belaş

Xalên giştî bê hesab an mifteya API-yê belaş in; ji bo her IP-yê 60 daxwaz/deqîqe û 1.200/saet.

Çavkaniyên Ajanê AI û Pêşvebir

Pelên ku ji aliyê makîneyê ve têne xwendin û dihêlin ajanên AI û amûrên pêşvebiran zû API ya LiraScope fam bikin.

Referansa API (Markdown)/api-docs.mdRêbera jêhatîbûnê ji bo ajanên AI/SKILLS.mdPêrista ajanê llms.txt/llms.txt

Nasîn û Nasîn

API-yê giştî ye û ji bo xalên giştî hewceyî nasînê tune ye

Nasnameyê NaxwazeXalên Giştî

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

60 daxwaz/deqîqe û 1.200/saet ji bo her IP-yê

Mifteya API Lazim eXalên Taybet

/client/*

Mifteyên API-yê kotaya mehane û webhookan didin; daxwazên pejirandî sînorê IP-ya hevpar derbas dikin.

Xalên Dawiyê

GET/rates/latest

Nirxên Dawî Bistînin

Nirxên dawî yên guhertinê ji Banka Navendî û çavkaniyên bazara reş bistînin

Parametreyên Pirsan

currenciesVebijêrk

Navnîşana diravên bi komayî veqetandî (mînak: USD,EUR)

langVebijêrk

Zimanê bersivê (ar, en, de, tr, ku, kmr) - Bingehîn: ar

Daxwaza Mînak

cURL

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

Bersiva Mînak

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

Rêjeyên Ser Bingeha USD Bîne

Rêjeyên herî dawî yên diravê bi USD wekî bingehê bistîne

Parametreyên Pirsan

langVebijêrk

Zimanê bersivê (ar, en, de, tr, ku, kmr) - Bingehîn: ar

Daxwaza Mînak

cURL

curl "https://lirascope.syria-cloud.sy/api/v1/rates/usd-based?lang=kmr"

Bersiva Mînak

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" }
  ]
}

Qadên Bersivê

base

Diravê bingehê (USD)

date

Dîroka nûvekirina rêjeyê ya dawî

rates[].currency

Koda diravê ya ISO 4217 (mînak EUR, GBP)

rates[].mid

Rêjeya navîn (referans) — 1 USD = X yekîne

rates[].buy

Rêjeya kirînê ya ji daneyên bazarê hatî wergirtin

rates[].sell

Rêjeya firotinê ya ji daneyên bazarê hatî wergirtin

rates[].timestampUtc

Dema nûvekirinê

GET/crypto/latest

Bihayên Krîptoyê yên Dawî

Bihayên krîptoyê yên herî dawî bi USD digel daneyên guhertina 24 saetan bistîne.

Parametreyên Pirsan

langVebijêrk

Zimanê bersivê (ar, en, de)

Daxwaza Mînak

cURL

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

GET/gold/latest

Bihayên Zêr yên Dawî

Bihayên zêr yên herî dawî bi USD digel daneyên guhertina 24 saetan bistîne.

Parametreyên Pirsan

langVebijêrk

Zimanê bersivê (ar, en, de)

Daxwaza Mînak

cURL

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

Qadên Bersivê

disclaimer

Mesaja redkeriya fermî

timestampUtc

Dema nûvekirina daneyê (UTC)

cbsRates

Nirxên Banka Navendî

marketRates

Nirxên bazarê

effectiveRates

Nirxên bandorker (guherînên destan an bazar)

[].currency

Koda diravê

[].buy

Nirxa kirînê

[].sell

Nirxa firotinê

[].mid

Nirxa navîn

[].timestampUtc

Dema nûvekirinê

[].isManualOverride

Gelo guherina destan e

Sînorên Nirxê

Bangên giştî li gorî IP-yê tên sînorkirin. Bangên pejirandî ji bo her mifteyê 60/deqîqe û kotaya mehane ya planê ne.

Ast	Nasname	Mehane	Di Deqîqeyekê de	Di Saetekê de
Belaş (IP)	Nasnameyê Naxwaze	—	60 / IP	1,200 / IP
Belaş	Mifteya API Lazim e	300	60 / key	—
Destpêk	Mifteya API Lazim e	10,000	60 / key	—
Profesyonel	Mifteya API Lazim e	500,000	60 / key	—
Pargîdaniyê	Mifteya API Lazim e	Bê Sînor	60 / key	—

Planên dayînî kotaya mehane û hejmara webhookan zêde dikin. Planan bibînin

Serêyên Sînorê Nirxê

Hemî bersivên API-yê agahiyên sînorê nirxê dihewîne:

HTTP

X-Rate-Limit-Limit: 60
X-Rate-Limit-Remaining: 58
X-Rate-Limit-Reset: 2026-02-04T10:15:00Z

Bersiva HTTP 429

Dema sînorê nirxê derbas bibe:

JSON

{
  "error": "Rate limit exceeded. Please retry after 45 seconds.",
  "retryAfter": 45
}

API-ya Taybet & Webhook

API-ya taybet dihêle ku hûn entegrasyonan bi hişyariyên webhook yên îmzekirî ji bo mercên nirxê ava bikin.

Nasîna API-ya Taybet

Hemû xalên /client/* hewceyî mifteyek giştî û mifteyekî taybet di sernavên daxwazê de ne.

X-Api-Key

Mifteya we ya giştî (lsp_pub_...)

X-Api-Secret

Mifteya we ya taybet (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..."

Mifteya taybet tenê carekê di dema afirandinê de tê nîşandan. Wê yekser li cihekî ewle tomar bikin.

GET/client/me

Profîla Xerîdar

Agahdariya hesabê xwe û jimara webhook yên tomarkirî bibînin.

Bersiva Mînak

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
}

Webhook

URL-yan tomar bikin da ku hişyariyên otomatîk werbigirin dema ku mercên nirxê pêk tên.

GET/client/webhooks— Hemû webhook lîste bikin

POST/client/webhooks— Webhookek nû biafirînin

PUT/client/webhooks/{id}— Webhookê nûve bikin

DELETE/client/webhooks/{id}— Webhookê jêbirin

Daxwaza Mînak

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"
  }'

Cureyên Hişyariyê

0 — ABOVE

Dema ku nirx ≥ sînor e bişkê

1 — BELOW

Dema ku nirx ≤ sînor e bişkê

2 — CHANGE_INCREASE

Dema ku nirx bi sînor% zêde dibe bişkê

3 — CHANGE_DECREASE

Dema ku nirx bi sînor% kêm dibe bişkê

Barkirina Webhook

Dema ku mercek hişyariyê pêk tê, LiraScope daxwazek POST ji URL-ya webhookê ya we re dişîne.

Sernav

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

Bersiva Mînak

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"
}

Piştrastkirina Îmzeyê

HMAC-SHA256 bi nihîniya îmzeyê ya carekê tê nîşandan li ser demjimêr.naverokaXav kontrol bike û demên ji pênc deqîqeyan kevntir red bike.

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);
}

Pêbawerbûna Webhook

Webhookên ku 10 caran li pey hev têk diçin bi otomatîk tên neçalakkirin.
Bi rêya panelê an xala PUT /client/webhooks/{id} dîsa çalak bikin.
Qadên lastDeliveryStatusCode û consecutiveFailures rewşa gihandînê nîşan didin.

Yekgirtin

LiraScope di WordPress û WHMCS de bi kar bîne an karteke nirxê ya pêvekirî biafirîne.

LiraScope ji bo WordPressê

Nirxên fermî û bazarê yên SYP, tabloyên cudahiyê, grafîk, veguherîner, blok, widget, derxistin û herikînên nirxê yên WooCommerceê zêde bike.

Li WordPress.org bibîne Guhertoya 1.0.0 daxîne

LiraScope ji bo WHMCS

Nirxên fermî û bazarê yên Lîra Sûrî li beşên rêveber û xerîdar nîşan bidin û nirxê fatûreyê yê SYP bi herikîneke vebijarkî, parastî û kontrolkirî nûve bikin.

Hûragahiyan bibîne Guhertoya 1.1.1 daxîne

Avakerê pêvekirinê

Ji bo her malperê karteke nirxê ya mêvandarkirî bêyî sazkirina pêvekekê mîheng bike.

Avakerê pêvekirinê veke

Piştgirî

Ji bo piştgirî yan raporkirin xeletî, ji kerema xwe bi me re têkilî daynin info@omarino.de