LiraScope
Geliştirici API

API Belgeleri

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

Fiyatlandırma Müşteri Portalı

Başlangıç

Temel URL
BASE 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.

Yapay Zeka Ajanı ve Geliştirici Kaynakları

Yapay zeka ajanlarının ve geliştirici araçlarının LiraScope API’sini hızlıca anlamasını sağlayan makine tarafından okunabilir dosyalar.

API referansı (Markdown)/api-docs.mdYapay zeka ajanları için beceri kılavuzu/SKILLS.mdllms.txt ajan dizini/llms.txt

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

GET/rates/latest

En Son Kurları Al

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

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
curl "https://lirascope.syria-cloud.sy/api/v1/rates/latest?currencies=USD,EUR&lang=tr"
Örnek Yanıt
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

USD Bazlı Kurları Getir

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

Sorgu Parametreleri
langİsteğe Bağlı

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

Örnek İstek
cURL
curl "https://lirascope.syria-cloud.sy/api/v1/rates/usd-based?lang=tr"
Örnek Yanıt
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 }
  ]
}
Yanıt Alanları
base

Baz para birimi (USD)

date

Son kur güncellemesinin tarihi

rates[].currency

ISO 4217 para birimi kodu (örn. EUR, GBP)

rates[].mid

Orta (referans) kur — 1 USD = X birim

rates[].buy

Piyasa verilerinden türetilen alış kuru

rates[].sell

Piyasa verilerinden türetilen satış kuru

GET/crypto/latest

Güncel Kripto Fiyatları

24 saatlik değişim verileriyle güncel kripto para fiyatlarını USD cinsinden alın.

Sorgu Parametreleri
langİsteğe Bağlı

Yanıt dili (ar, en, de)

Örnek İstek
cURL
curl "https://lirascope.syria-cloud.sy/api/v1/crypto/latest?lang=tr"
GET/gold/latest

Güncel Altın Fiyatları

24 saatlik değişim verileriyle güncel altın fiyatlarını USD cinsinden alın.

Sorgu Parametreleri
langİsteğe Bağlı

Yanıt dili (ar, en, de)

Örnek İstek
cURL
curl "https://lirascope.syria-cloud.sy/api/v1/gold/latest?lang=tr"

Yanıt Alanları

disclaimer

Sorumluluk reddi mesajı (yerelleştirilmiş)

timestampUtc

UTC Zaman Damgası

cbsRates

Merkez Bankası kurları

marketRates

Piyasa kurları

effectiveRates

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

[].currency

Para birimi kodu

[].buy

Alış kuru

[].sell

Satış kuru

[].mid

Orta kur

[].timestampUtc

Güncelleme zamanı

[].isManualOverride

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

KatmanKimlik DoğrulamaAylıkDakika BaşınaSaat Başına
Ücretsiz (IP)Kimlik Doğrulama Yok3005100
BaşlangıçAPI Anahtarı Gerekli10,0001001,000
ProfesyonelAPI Anahtarı Gerekli500,00050020,000
KurumsalAPI Anahtarı GerekliSınırsızSınırsızSı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:

HTTP
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:

JSON
{
  "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-Key

Genel anahtarınız (lsp_pub_...)

X-Api-Secret

Özel anahtarınız (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..."
Özel anahtar yalnızca oluşturma sırasında bir kez gösterilir. Hemen güvenli bir yere kaydedin.
GET/client/me

İstemci Profili

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

Örnek Yanıt
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'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
PUT/client/webhooks/{id}— Webhook'u güncelle
DELETE/client/webhooks/{id}— Webhook'u sil
Örnek İstek
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"
  }'
Uyarı Türleri
0 — ABOVE

Kur ≥ eşik değerine ulaştığında tetikle

1 — BELOW

Kur ≤ eşik değerine düştüğünde tetikle

2 — CHANGE_INCREASE

Kur eşik % oranında arttığında tetikle

3 — CHANGE_DECREASE

Kur eşik % oranında azaldığında tetikle

Webhook İçeriği

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

Başlıklar
HTTP
Content-Type: application/json
X-LiraScope-Signature: sha256=<hex-digest>
X-LiraScope-Event: rate_alert
Örnek Yanıt
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"
}

İmza Doğrulaması

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

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