LiraScope
Entwickler-API

API-Dokumentation

Verwenden Sie unsere öffentliche API, um Echtzeit-Wechselkursdaten für das syrische Pfund abzurufen

Preise Kundenportal

Erste Schritte

Basis-URL
BASE URL
https://lirascope.syria-cloud.sy/api/v1
Freier API-Zugang
Öffentliche Endpunkte sind ohne Konto oder API-Schlüssel kostenlos: 60 Anfragen/Minute und 1.200/Stunde pro IP.

KI-Agenten- & Entwickler-Ressourcen

Maschinenlesbare Dateien, mit denen KI-Agenten und Entwicklertools die LiraScope-API schnell verstehen.

API-Referenz (Markdown)/api-docs.mdSkill-Leitfaden für KI-Agenten/SKILLS.mdllms.txt Agenten-Index/llms.txt

Authentifizierung

Die API ist öffentlich und erfordert keine Authentifizierung für öffentliche Endpunkte

Keine AuthÖffentliche Endpunkte
  • /rates/*
  • /crypto/*
  • /gold/*
  • /pricing

60 Anfragen/Minute und 1.200/Stunde pro IP

API-Schlüssel erforderlichPrivate Endpunkte
  • /client/*

API-Schlüssel bieten Monatskontingent und Webhooks; verifizierte Anfragen umgehen das gemeinsame IP-Limit.

Endpunkte

GET/rates/latest

Aktuelle Kurse abrufen

Rufen Sie die aktuellen Wechselkurse von der Zentralbank und Schwarzmarktquellen ab

Abfrageparameter
currenciesOptional

Kommagetrennte Liste von Währungen (z. B. USD,EUR)

langOptional

Sprachcode (ar, en, de) - Standard: ar

Beispielanfrage
cURL
curl "https://lirascope.syria-cloud.sy/api/v1/rates/latest?currencies=USD,EUR&lang=de"
Beispielantwort
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-Kurse abrufen

Aktuelle Wechselkurse mit USD als Basiswährung abrufen

Abfrageparameter
langOptional

Sprachcode (ar, en, de) - Standard: ar

Beispielanfrage
cURL
curl "https://lirascope.syria-cloud.sy/api/v1/rates/usd-based?lang=de"
Beispielantwort
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" }
  ]
}
Antwortfelder
base

Basiswährung (USD)

date

Datum der letzten Kurs-Aktualisierung

rates[].currency

ISO-4217-Währungscode (z. B. EUR, GBP)

rates[].mid

Mittelkurs (Referenzkurs) — 1 USD = X Einheiten

rates[].buy

Aus Marktdaten abgeleiteter Kaufkurs

rates[].sell

Aus Marktdaten abgeleiteter Verkaufskurs

rates[].timestampUtc

Aktualisierungszeit

GET/crypto/latest

Aktuelle Krypto-Preise

Erhalten Sie die aktuellen Kryptowährungspreise in USD mit 24-Stunden-Änderungsdaten.

Abfrageparameter
langOptional

Antwortsprache (ar, en, de)

Beispielanfrage
cURL
curl "https://lirascope.syria-cloud.sy/api/v1/crypto/latest?lang=de"
GET/gold/latest

Aktuelle Goldpreise

Erhalten Sie die aktuellen Goldpreise in USD mit 24-Stunden-Änderungsdaten.

Abfrageparameter
langOptional

Antwortsprache (ar, en, de)

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

Antwortfelder

disclaimer

Haftungsausschlussmeldung (lokalisiert)

timestampUtc

UTC-Zeitstempel

cbsRates

Zentralbankkurse

marketRates

Marktkurse

effectiveRates

Effektive Kurse (manuelle Überschreibungen oder Markt)

[].currency

Währungscode

[].buy

Kaufkurs

[].sell

Verkaufskurs

[].mid

Mittelkurs

[].timestampUtc

Aktualisierungszeit

[].isManualOverride

Ob es ein manueller Kurs ist

Ratenlimits

Öffentliche Aufrufe sind pro IP begrenzt. Verifizierte Aufrufe sind auf 60/Minute pro Schlüssel plus Monatskontingent begrenzt.

StufeAuthentifizierungMonatlichPro MinutePro Stunde
Kostenlos (IP)Keine Auth—60 / IP1,200 / IP
KostenlosAPI-Schlüssel erforderlich30060 / key—
StarterAPI-Schlüssel erforderlich10,00060 / key—
ProfessionalAPI-Schlüssel erforderlich500,00060 / key—
EnterpriseAPI-Schlüssel erforderlichUnbegrenzt60 / key—

Bezahlte Tarife erhöhen Monatskontingent und Webhook-Anzahl. Pläne anzeigen

Ratenlimit-Header

Alle API-Antworten enthalten Ratenlimit-Informationen:

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

Wenn das Ratenlimit überschritten wird:

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

Private API & Webhooks

Die Private API ermöglicht Integrationen mit signierten Webhook-Benachrichtigungen für Wechselkursbedingungen.

Authentifizierung der privaten API

Alle /client/*-Endpunkte erfordern einen öffentlichen und einen privaten Schlüssel in den Anfrage-Headern.

X-Api-Key

Ihr öffentlicher Schlüssel (lsp_pub_...)

X-Api-Secret

Ihr privater Schlüssel (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..."
Der private Schlüssel wird nur einmal bei der Erstellung angezeigt. Speichern Sie ihn sofort sicher ab.
GET/client/me

Client-Profil

Zeigen Sie Ihre Kontoinformationen und die Anzahl registrierter Webhooks an.

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

Webhooks

Registrieren Sie URLs, um automatische Benachrichtigungen bei Kursbedingungen zu erhalten.

GET/client/webhooks— Alle Webhooks auflisten
POST/client/webhooks— Neuen Webhook erstellen
PUT/client/webhooks/{id}— Webhook aktualisieren
DELETE/client/webhooks/{id}— Webhook löschen
Beispielanfrage
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"
  }'
Benachrichtigungstypen
0 — ABOVE

Auslösen wenn Kurs ≥ Schwellenwert

1 — BELOW

Auslösen wenn Kurs ≤ Schwellenwert

2 — CHANGE_INCREASE

Auslösen bei Kursanstieg um Schwellenwert %

3 — CHANGE_DECREASE

Auslösen bei Kursrückgang um Schwellenwert %

Webhook-Payload

Wenn eine Benachrichtigungsbedingung erfüllt ist, sendet LiraScope eine POST-Anfrage an Ihre Webhook-URL.

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

Signaturüberprüfung

Prüfen Sie HMAC-SHA256 mit dem einmal angezeigten Signaturgeheimnis über Zeitstempel.Rohtext und lehnen Sie Zeitstempel ab, die älter als fünf Minuten sind.

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-Zuverlässigkeit

  • Webhooks, die 10 Mal hintereinander fehlschlagen, werden automatisch deaktiviert.
  • Reaktivieren Sie über das Dashboard oder den PUT /client/webhooks/{id}-Endpunkt.
  • Die Felder lastDeliveryStatusCode und consecutiveFailures zeigen den Zustellungsstatus.

Integrationen

Nutzen Sie LiraScope in WordPress und WHMCS oder erstellen Sie eine einbettbare Kurskarte.

LiraScope für WordPress

Fügen Sie offizielle und marktbasierte SYP-Kurse, Kursspannen, Tabellen, Diagramme, Umrechner, Blöcke, Widgets, Exporte und WooCommerce-Kursfeeds hinzu.

Auf WordPress.org ansehen Version 1.0.0 herunterladen

LiraScope für WHMCS

Zeigen Sie amtliche und marktbasierte Kurse des Syrischen Pfunds im Admin- und Kundenbereich an und aktualisieren Sie den SYP-Abrechnungskurs über einen optionalen, abgesicherten und prüfbaren Feed.

Details ansehen Version 1.1.1 herunterladen

Einbettungs-Builder

Konfigurieren Sie eine gehostete Kurskarte für jede Website, ohne ein Plugin zu installieren.

Einbettungs-Builder öffnen

Support

Für Support oder um Probleme zu melden, kontaktieren Sie bitte info@omarino.de