LiraScope
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

Bihayên û Pakêt Portala Xerîdar

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ê bi belaş in. Heta 300 daxwaz/meh ji bo her IP-yekê.

Ç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

300 daxwaz/meh ji bo her IP — bi tevahî belaş

Mifteya API Lazim eXalên Taybet
  • /client/*

Ji bo sînorên bilindtir bibin endamên plan

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

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ê

Ji bo parastina API-yê ji karanîna xelet, sînorên nirxê li jêr li hemû xalên giştî tên sepandin.

AstNasnameMehaneDi Deqîqeyekê deDi Saetekê de
Belaş (IP)Nasnameyê Naxwaze3005100
DestpêkMifteya API Lazim e10,0001001,000
ProfesyonelMifteya API Lazim e500,00050020,000
PargîdaniyêMifteya API Lazim eBê SînorBê SînorBê Sînor

Ji bo sînorên bilindtir, pêşve biçin planeke dayînî. 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: 5
X-Rate-Limit-Remaining: 3
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: sha256=<hex-digest>
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ê

Bi HMAC-SHA256 û mifteya xwe ya giştî wekî nepenî rastbûna barkirinê kontrol bikin.

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

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.

Piştgirî

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