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

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 ücretsizdir; IP başına dakikada 60 ve saatte 1.200 istekle sınırlıdır.

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 dakikada 60 ve saatte 1.200 istek

API Anahtarı GerekliÖzel Uç Noktalar

/client/*

API anahtarları aylık kota ve webhook sunar; doğrulanmış istekler paylaşılan IP sınırını aşar.

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

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

rates[].timestampUtc

Güncelleme zamanı

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ı

Genel çağrılar IP başına sınırlıdır. Doğrulanmış çağrılar anahtar başına dakikada 60 ve planın aylık kotasıyla sınırlıdır.

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

Ücretli planlar aylık kotayı ve webhook sayısını artırır. 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: 60
X-Rate-Limit-Remaining: 58
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-Version: 2
X-LiraScope-Timestamp: <unix-seconds>
X-LiraScope-Signature-256: <hex-hmac>
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ı

Tek sefer gösterilen imzalama sırrıyla zamanDamgası.hamGövde üzerinde HMAC-SHA256 doğrulayın ve beş dakikadan eski zaman damgalarını reddedin.

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

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.

Entegrasyonlar

LiraScope'u WordPress ve WHMCS'te kullanın veya gömülebilir bir kur kartı oluşturun.

WordPress için LiraScope

Resmî ve piyasa SYP kurları, fark tabloları, grafikler, dönüştürücüler, bloklar, bileşenler, dışa aktarımlar ve WooCommerce kur akışları ekleyin.

WordPress.org'da görüntüle 1.0.0 sürümünü indir

WHMCS için LiraScope

Yönetici ve müşteri alanlarında resmî ve piyasa Suriye Lirası kurlarını gösterin; SYP faturalama kurunu isteğe bağlı, korumalı ve denetlenebilir bir akışla güncelleyin.

Ayrıntıları görüntüle 1.1.1 sürümünü indir

Gömme oluşturucu

Eklenti kurmadan herhangi bir web sitesi için barındırılan bir kur kartı yapılandırın.

Gömme oluşturucuyu aç

Destek

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