> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Einführung

> Die Cleariflow Wechselkurs-API bietet Echtzeit-Währungsumrechnung über eine schlanke, moderne RESTful JSON-Schnittstelle — mit Unterstützung für über 80 globale Währungen, Live-Kursen und Sofortumrechnung.

## Erste Schritte

<Card title="Live-Wechselkurse" icon="activity" href="exchange-rates/live">
  Der `live`-Endpunkt bietet sofortigen Zugriff auf aktuelle Wechselkurse für mehrere Währungen — für Echtzeit-Finanzberechnungen und Marktmonitoring.
</Card>

<Card title="Währungsumrechnung" icon="arrow-left-right" href="exchange-rates/convert">
  Der `convert`-Endpunkt rechnet bestimmte Beträge zwischen Währungen mit den aktuellsten Wechselkursen um — ideal für Finanzanwendungen und E-Commerce-Plattformen.
</Card>

<Card title="Verfügbare Währungssymbole" icon="circle-dollar-sign" href="exchange-rates/symbols">
  Der `symbols`-Endpunkt liefert einen umfassenden Katalog unterstützter Währungen mit detaillierten Beschreibungen für dynamische Währungsauswahl und Validierung in Anwendungen.
</Card>

### REST-Architektur

Die Wechselkurs-API folgt REST-Prinzipien mit vorhersehbaren, ressourcenorientierten URLs und standardmäßigen HTTP-Statuscodes für nahtlose Integration und Fehlerbehandlung.

### HTTPS-Sicherheit

Alle API-Kommunikation wird mit TLS 1.2 oder höher verschlüsselt, um Datenintegrität und Datenschutz zu gewährleisten.

### API-Versionierung

Die Wechselkurs-API bleibt durch Versionierung abwärtskompatibel und befindet sich derzeit in Version 1 mit geplanten zukünftigen Erweiterungen.

### Authentifizierung

Ihr API-Schlüssel ist die ausschließliche Berechtigung für den Zugriff auf die Wechselkurs-API. Jeder Cleariflow-Dienst erfordert einen eigenen Schlüssel für sicheren und isolierten Zugriff.

## Antwort- und Fehlercodes

Bei fehlgeschlagenen Anfragen liefert die API strukturierte JSON-Fehlerantworten mit spezifischen Codes und Beschreibungen zur effektiven Fehlerbehebung.

| Code | Typ                   | Beschreibung                                                                                                    |
| ---- | --------------------- | --------------------------------------------------------------------------------------------------------------- |
| 200  | OK                    | Alles funktionierte wie erwartet.                                                                               |
| 204  | OK                    | Für die übermittelte IP liegen keine Standortdaten vor.                                                         |
| 400  | Bad request           | Fehlerhafte Anfrage.                                                                                            |
| 401  | Unauthorized          | Die Anfrage war nicht zulässig — in der Regel fehlt der API-Schlüssel oder er ist ungültig.                     |
| 422  | Quota reached         | Die Anfrage wurde abgebrochen, da nicht genügend API-Guthaben vorhanden ist (kostenlose Tarife).                |
| 429  | Too many requests     | Das Anfragenlimit pro Sekunde wurde erreicht. Bei kostenlosen Tarifen gilt ein Limit von 1 Anfrage pro Sekunde. |
| 500  | Internal server error | Die Anfrage konnte aufgrund eines Serverfehlers nicht abgeschlossen werden.                                     |
| 503  | Service unavailable   | Der Server war nicht verfügbar.                                                                                 |