Zum Inhalt springen
EasyAlgerie

EasyAlgerie · Entwickler

Kostenlose API für den algerischen Dinar

Binden Sie Dinar-Wechselkurse und Währungsumrechnungen in Ihre Website, App oder Ihren KI-Agenten ein. Einfache JSON-Antworten, ohne Konto und ohne API-Schlüssel.

  • Ohne Authentifizierung
  • 11 Währungen ↔ DZD
  • Nur Lesezugriff

Ihre erste Anfrage

Kopieren Sie dieses Beispiel in Ihr Terminal, um 100 Euro zum unverbindlichen Ankaufskurs des Parallelmarkts in Dinar umzurechnen.

curl 'https://easyalgerie.com/api/v1/dinar/convert?amount=100&from=EUR&to=DZD&market=parallel_buy'
JSON-Antwort ansehen

Zwei Endpunkte, ein einfaches Format

Basis-URL : https://easyalgerie.com/api/v1/dinar

GET /rates — Wechselkurse abrufen

Die Kurse werden in DZD je 1 Einheit Fremdwährung angegeben. Ohne Filter enthält die Antwort alle 11 unterstützten Währungen.

curl 'https://easyalgerie.com/api/v1/dinar/rates?currency=EUR'
currency
Optional: Code einer Fremdwährung, etwa EUR oder USD. DZD darf hier nicht verwendet werden.

GET /convert — Einen Betrag umrechnen

Rechnen Sie Fremdwährung in Dinar oder Dinar in Fremdwährung um. Genau eine der beiden Währungen muss DZD sein: Eine direkte EUR/USD-Umrechnung wird nicht unterstützt.

amount
Erforderlich. Von 0 bis 1.000.000.000, mit Dezimalpunkt und bis zu 6 Nachkommastellen. Ohne Tausendertrennzeichen oder Exponentialschreibweise.
from / to
Erforderlich. ISO-Codes der Ausgangs- und Zielwährung. Genau eine muss DZD sein.
market
Optional. official, parallel_buy oder parallel_sell. Standardwert: parallel_buy.

Bei Währungscodes spielt Groß- und Kleinschreibung keine Rolle. Unbekannte oder doppelte Parameter werden abgelehnt.

Unterstützte Währungen

DZDEURUSDCADGBPCHFTRYCNYSARAEDTNDMAD

Den richtigen Kurs wählen

official
Bankbezogener Referenzkurs eines Wechselkursanbieters; kein verbindliches Angebot einer Bank.
parallel_buy
Die Wechselstube kauft dem Kunden Fremdwährung ab und zahlt dafür Dinar.
parallel_sell
Die Wechselstube verkauft dem Kunden Fremdwährung gegen Dinar.

Der gewählte Markt gilt für beide Umrechnungsrichtungen. Die API wechselt nicht automatisch zu einem anderen Kurs.

Die Antwort verstehen

result
Umgerechneter Betrag, auf zwei Nachkommastellen gerundet; bei genau der Hälfte wird aufgerundet.
rate
Multiplikator: 1 Einheit von from = rate Einheiten von to.
dzdPerUnit
Zugrunde liegender Referenzkurs in DZD je 1 Einheit Fremdwährung.
provenance
Herkunft, Quelle und verfügbarer Zeitstempel des Werts.

Herkunft und Aktualität der Daten

provider
Kurs von einem externen Anbieter.
editorial
Redaktioneller Kurs des öffentlichen Währungsrechners, einschließlich manuell von EasyAlgerie eingegebener Werte.
fallback
Statischer Ersatzwert. Nicht als aktuellen Marktkurs darstellen.

sourceUpdatedAt enthält den Zeitstempel der Quelle; null bedeutet unbekannt. Bei manuellen Kursen ist dies der UTC-Zeitpunkt der Bearbeitung, keine unabhängige Marktbeobachtung. retrievedAt bezeichnet den Abruf des Datenstands, nicht die Festlegung des Kurses.

Externe Quellen werden 6 Stunden zwischengespeichert. Manuelle Kurse haben Vorrang; ihr Cache wird beim Speichern verworfen (Ersatz-TTL: 30 Sekunden). refreshIntervalSeconds bezieht sich auf externe Quellen.

Die Umrechnungen sind unverbindlich und lösen weder Transaktionen noch Wechselkursgarantien aus. Öffentliche Kurse sind von den kommerziellen Kursen für EasyAlgerie-Zahlungen getrennt.

Limits und Fehlerbehandlung

60 Anfragen pro Minute und IP-Adresse, gemeinsam für /rates und /convert. Die Header RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset beschreiben das Kontingent. Speichern Sie Kurse für wiederholte Berechnungen zwischen.

400
Ungültige Parameter: error.code, error.message und error.field prüfen.
405
Methode nicht erlaubt. Daten mit GET abrufen.
429
Kontingent überschritten: die in Retry-After angegebene Anzahl Sekunden warten.
503
Daten vorübergehend nicht verfügbar. Später erneut versuchen, ohne schnelle Wiederholungsschleifen.

Öffentliches CORS: Browseranfragen sind ohne Cookies oder Zugangsdaten erlaubt. Es wird kein geheimer API-Schlüssel benötigt.

JavaScript-Beispiel

const url = new URL("https://easyalgerie.com/api/v1/dinar/convert");
url.search = new URLSearchParams({
  amount: "100", from: "EUR", to: "DZD", market: "parallel_buy"
}).toString();

const response = await fetch(url, { credentials: "omit" });
if (response.status === 429) {
  throw new Error("Retry after " + response.headers.get("Retry-After") + " seconds");
}
const data = await response.json();
if (!response.ok) throw new Error(data.error?.message || "API unavailable");

console.log(data.result, data.to);
console.log(data.provenance);

Einen KI-Agenten anbinden

  1. Importieren Sie die OpenAPI-Spezifikation in ein kompatibles Werkzeug, ohne Authentifizierung. Nicht jeder Agent unterstützt den automatischen Import.
  2. Verwenden Sie getDinarExchangeRates zum Abrufen der Kurse und convertAlgerianDinars zum Umrechnen. Geben Sie den gewählten Markt ausdrücklich an.
  3. Prüfen Sie vor der Antwort Herkunft und Zeitstempel. Stellen Sie redaktionelle Kurse oder Ersatzwerte nicht als Echtzeitkurse dar.
  4. Klären Sie mehrdeutige Beträge: 1 DZD = 100 Centimes. Wenn jemand von „Millionen“ spricht, fragen Sie, ob Dinar oder Centimes gemeint sind.
OpenAPI öffnen