API Belgeleri

Gerçek zamanlı Suriye Lirası döviz kuru verilerine erişmek için herkese açık API'mizi kullanın

Temel URL

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

🆓

Ücretsiz API Erişimi

Genel uç noktalar hesap veya API anahtarı olmadan ücretsiz erişilebilir. IP başına aylık 300 isteğe kadar.

Kimlik Doğrulama

API herkese açıktır ve herkese açık uç noktalar için kimlik doğrulama gerektirmez

Kimlik Doğrulama YokGenel Uç Noktalar

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

IP başına aylık 300 istek — tamamen ücretsiz

API Anahtarı GerekliÖzel Uç Noktalar

/client/*

Daha yüksek limitler için abone olun

Uç Noktalar

En Son Kurları Al

Merkez Bankası ve kara piyasa kaynaklarından en son döviz kurlarını alın

GET/rates/latest

Sorgu Parametreleri

currencies(İsteğe Bağlı)

Virgülle ayrılmış para birimi listesi (örn. USD,EUR)

lang(İsteğe Bağlı)

Dil kodu (ar, en, de) - Varsayılan: ar

Örnek İstek

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

Örnek Yanıt

{
  "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": [...]
}

USD Bazlı Kurları Getir

USD baz alınarak en son döviz kurlarını alın

GET/rates/usd-based

Sorgu Parametreleri

lang(İsteğe Bağlı)

Dil kodu (ar, en, de) - Varsayılan: ar

Örnek İstek

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

Örnek Yanıt

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

Yanıt Alanları

baseBaz para birimi (USD)

dateSon kur güncellemesinin tarihi

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

Sorgu Parametreleri

lang(İsteğe Bağlı)

Response language (ar, en, de)

Örnek İstek

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

Latest Gold Prices

Get the latest gold prices in USD with 24h change data.

GET/gold/latest

Sorgu Parametreleri

lang(İsteğe Bağlı)

Response language (ar, en, de)

Örnek İstek

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

Yanıt Alanları

disclaimerSorumluluk reddi mesajı (yerelleştirilmiş)

timestampUtcUTC Zaman Damgası

cbsRatesMerkez Bankası kurları

marketRatesPiyasa kurları

effectiveRatesEtkin kurlar (manuel geçersiz kılmalar veya piyasa)

currencyPara birimi kodu

buyAlış kuru

sellSatış kuru

midOrta kur

timestampUtcGüncelleme zamanı

isManualOverrideManuel kur olup olmadığı

Oran Sınırları

API'yi kötüye kullanımdan korumak için, tüm herkese açık uç noktalara aşağıdaki oran sınırları uygulanır.

Katman	Kimlik Doğrulama	Aylık	Dakika Başına	Saat Başına
Ücretsiz (IP)	Kimlik Doğrulama Yok	300	5	100
Başlangıç	API Anahtarı Gerekli	10,000	100	1,000
Profesyonel	API Anahtarı Gerekli	500,000	500	20,000
Kurumsal	API Anahtarı Gerekli	Sınırsız	Sınırsız	Sınırsız

Daha yüksek limitler için ücretli bir plana yükseltin. Planları Görüntüle

Oran Sınırı Başlıkları

Tüm API yanıtları oran sınırı bilgilerini içerir:

X-Rate-Limit-Limit: 5
X-Rate-Limit-Remaining: 3
X-Rate-Limit-Reset: 2026-02-04T10:15:00Z

HTTP 429 Yanıtı

Oran sınırı aşıldığında:

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

Özel API & Webhook'lar

Özel API, imzalı webhook uyarılarıyla döviz kuru koşulları için entegrasyonlar oluşturmanızı sağlar.

Özel API Kimlik Doğrulaması

Tüm /client/* uç noktaları, istek başlıklarında genel ve özel anahtar gerektirir.

X-Api-KeyGenel anahtarınız (lsp_pub_...)

X-Api-SecretÖzel anahtarınız (lsp_prv_...)

Örnek İstek

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

⚠️ Özel anahtar yalnızca oluşturma sırasında bir kez gösterilir. Hemen güvenli bir yere kaydedin.

İstemci Profili

Hesap bilgilerinizi ve kayıtlı webhook sayınızı görüntüleyin.

GET/client/me

Örnek Yanıt

{
  "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'lar

Kur koşulları karşılandığında otomatik uyarılar almak için URL'ler kaydedin.

GET/client/webhooks— Tüm webhook'ları listele

POST/client/webhooks— Yeni webhook oluştur

Örnek İstek

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

Uyarı Türleri

0 — ABOVEKur ≥ eşik değerine ulaştığında tetikle

1 — BELOWKur ≤ eşik değerine düştüğünde tetikle

2 — CHANGE_INCREASEKur eşik % oranında arttığında tetikle

3 — CHANGE_DECREASEKur eşik % oranında azaldığında tetikle

PUT/client/webhooks/{id}— Webhook'u güncelle

DELETE/client/webhooks/{id}— Webhook'u sil

Webhook İçeriği

Bir uyarı koşulu karşılandığında, LiraScope yapılandırılmış webhook URL'nize bir POST isteği gönderir.

Headers

Content-Type: application/json
X-LiraScope-Signature: sha256=<hex-digest>
X-LiraScope-Event: rate_alert

Örnek Yanıt

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

İmza Doğrulaması

HMAC-SHA256 kullanarak ve genel anahtarınızı gizli anahtar olarak kullanarak içerik doğruluğunu kontrol edin.

// 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 Güvenilirliği

Art arda 10 kez başarısız olan webhook'lar otomatik olarak devre dışı bırakılır.
Kontrol paneli veya PUT /client/webhooks/{id} uç noktası ile yeniden etkinleştirin.
lastDeliveryStatusCode ve consecutiveFailures alanları teslimat durumunu gösterir.

Destek

Destek veya sorunları bildirmek için lütfen iletişime geçin info@omarino.de