RealTestData API Dokumentation

🚀 Erste Schritte

Willkommen zur RealTestData API Dokumentation. Diese API ermöglicht es Ihnen, realistische Testdaten für Ihre Anwendungen mit unseren fortschrittlichen Algorithmen zu generieren.

Verwendung der API und Web-Version im Container

Öffnen Sie in Ihrem Webbrowser "rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io" für die API, die "This is RealTestData API" anzeigt.
Mit "rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/docs/<sprache>" wird diese Dokumentation in der jeweiligen Sprache angezeigt
In diesem Verzeichnis finden Sie auch die Python-Datei "RealTestData_API_Generate.py" mit einem Beispiel für die Verwendung der API mit Python.
In diesem Verzeichnis finden Sie auch die JavaScript-Datei "RealTestData_API_Generate.js" mit einem Beispiel für die Verwendung der API mit JavaScript.
"https:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/" ist die Web-Version von RealTestData, die vollständig auf der API basiert

Basis-URL für die API

API Endpunkt

http://<api-ip>:8000

Beispiel: http:/rtdapi.proudglacier-6fd951f3.westeurope.azurecontainerapps.io

Basis-URL für das Web-Frontend

Web Frontend

http://<web-ip>

Beispiel: http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io

Authentifizierung

Die meisten Endpunkte sind mit JWT geschützt, da sie eine Lizenz zur Nutzung benötigen. Nach erfolgreichem Login (mit entsprechender Lizenz) erhalten Sie ein access_token, das Sie in jeden Header einbinden müssen:

Authorization: Bearer <access_token>

API Endpunkte

GET /

API Startseite

Antwort: "This is RealTestData API"

cURL Beispiel:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/

Python Beispiel:

import requests
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/")
print(r.text)

Postman Beispiel:

{
   "method": "GET",
   "url": "{{base_url}}/",
   "headers": {}
}

POST /register

Benutzerregistrierung

Registriert einen neuen Benutzer und sendet einen Aktivierungslink per E-Mail.

Body (JSON):

{
   "username": "max",
   "password": "geheim",
   "email": "max@example.com",
   "forename": "Max",
   "lastname": "Mustermann",
   "phone": "0123456789",
   "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"
}

Antwort:

{
   "status": 201,
   "message": "Benutzer max erfolgreich registriert. Bitte überprüfen Sie Ihre E-Mail zur Aktivierung des Kontos."
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/register \
-H "Content-Type: application/json" \
-d '{"username":"max","password":"geheim","email":"max@example.com","forename":"Max","lastname":"Mustermann","phone":"0123456789","webserver":"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}'

Python Beispiel:

import requests
data = {
   "username": "max",
   "password": "geheim", 
   "email": "max@example.com",
   "forename": "Max",
   "lastname": "Mustermann",
   "phone": "0123456789",
   "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"
}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/register", json=data)
print(r.json())

POST /activate/<token>

Konto-Aktivierung

Aktiviert ein Benutzerkonto über den Link in der E-Mail. Nur dann können Sie sich anmelden.

Antwort:

{
   "status": 200,
   "message": "Konto erfolgreich aktiviert"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/activate/<token>

Python Beispiel:

import requests
token = "ihr_aktivierungs_token_hier"
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/activate/{token}")
print(r.json())

POST /login

Benutzeranmeldung

Benutzeranmeldung, gibt JWT-Token zurück.

Body (JSON):

{
   "username": "max",
   "password": "geheim"
}

Antwort:

{
   "status": 200,
   "access_token": "<JWT>",
   "message": "Erfolgreiche Anmeldung",
   "forename": "Max",
   "lastname": "Mustermann",
   "email": "max@example.com",
   "countries": "DE;AT;CH",
   "version": 100,
   "until": "2024-12-31"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/login \
-H "Content-Type: application/json" \
-d '{"username":"max","password":"geheim"}'

Python Beispiel:

import requests
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/login", json={"username":"max","password":"geheim"})
print(r.json())

GET /user/<name> 🔒 Erfordert Authentifizierung

Benutzerdetails

Details über einen Benutzer (JWT erforderlich, nur eigener Benutzer).

Antwort:

{
   "status": 200,
   "message": "Benutzer gefunden",
   "user": { ... }
}

cURL Beispiel:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/user/max \
-H "Authorization: Bearer <access_token>"

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>"}
username = "max"
r = requests.get(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/user/{username}", headers=headers)
print(r.json())

POST /change_password 🔒 Erfordert Authentifizierung

Passwort ändern

Passwort ändern (JWT erforderlich).

Body (JSON):

{
   "old_password": "altes_passwort",
   "new_password": "neues_passwort"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/change_password \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"old_password":"altes_passwort","new_password":"neues_passwort"}'

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"old_password": "altes_passwort", "new_password": "neues_passwort"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/change_password", headers=headers, json=data)
print(r.json())

POST /logout 🔒 Erfordert Authentifizierung

Benutzerabmeldung

Abmelden (JWT erforderlich, Token wird ungültig).

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/logout \
-H "Authorization: Bearer <access_token>"

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/logout", headers=headers)
print(r.json())

POST /password_reset_request

Passwort-Reset-Anfrage

Fordert einen Passwort-Reset-Link per E-Mail an.

Body (JSON):

{
   "email": "max@example.com",
   "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"
}

Antwort:

{
   "status": 200,
   "message": "Passwort-Reset-Link erfolgreich gesendet",
   "reset_link": "<URL>"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/password_reset_request \
-H "Content-Type: application/json" \
-d '{"email":"max@example.com","webserver":"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}'

Python Beispiel:

import requests
data = {"email": "max@example.com", "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/password_reset_request", json=data)
print(r.json())

POST /password_reset/<token>

Passwort zurücksetzen

Passwort mit Token aus E-Mail zurücksetzen.

Body (JSON):

{
   "new_password": "neues_passwort",
   "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"
}

Antwort:

{
   "status": 200,
   "message": "Passwort erfolgreich zurückgesetzt"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/password_reset/<token> \
-H "Content-Type: application/json" \
-d '{"new_password":"neues_passwort","webserver":"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}'

Python Beispiel:

import requests
token = "reset_token_hier"
data = {"new_password": "neues_passwort", "webserver": "http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io"}
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/password_reset/{token}", json=data)
print(r.json())

POST /generate 🔒 Erfordert Authentifizierung

Testdaten generieren

Generiert Testdaten (JWT erforderlich)

Body (JSON):

{
   "version": 0
}

Antwort:

{
   "status": 200,
   "message": "Datei erfolgreich generiert",
   "filename": "testdata_20231201_143052.csv",
   "path": "/app/ResultData/"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/generate \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"version":0}'

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"version": 0}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/generate", headers=headers, json=data)
print(r.json())

POST /generate_live 🔒 Erfordert Authentifizierung

Testdaten Live generieren

Generiert Testdaten und liefert sie direkt als JSON (JWT erforderlich).

Body (JSON):

{
   "version": 0
}

Antwort:

{
   "status": 200,
   "message": "Datei erfolgreich generiert",
   "filename": "testdata.json",
   "path": "/app/ResultData/",
   "result": { ... }
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/generate_live \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"version":0}'

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"version": 0}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/generate_live", headers=headers, json=data)
print(r.json())

GET /download/<filename> 🔒 Erfordert Authentifizierung

Generierte Datei herunterladen

Lädt eine mit "/generate" generierte Datei herunter.

cURL Beispiel:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/download/testdata_20231201_143052.csv \
-H "Authorization: Bearer <access_token>" \
-o testdata.csv

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>"}
filename = "testdata_20231201_143052.csv"
r = requests.get(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/download/{filename}", headers=headers)
with open(filename, 'wb') as f:
    f.write(r.content)

POST /countrylist 🔒 Erfordert Authentifizierung

Länderliste abrufen

Gibt eine gefilterte Länderliste zurück (JWT erforderlich).

Body (JSON):

{
   "usercountries": "DE;AT;CH"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countrylist \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"usercountries":"DE;AT;CH"}'

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"usercountries": "DE;AT;CH"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countrylist", headers=headers, json=data)
print(r.json())

GET POST /config 🔒 Erfordert Authentifizierung

Konfigurationsverwaltung

Liest oder speichert die Konfiguration (JWT erforderlich).

GET: Lädt die Konfiguration.
POST: Speichert die Konfiguration.

cURL Beispiel (GET):

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/config \
-H "Authorization: Bearer <access_token>"

Python Beispiel (GET):

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/config", headers=headers)
print(r.json())

GET POST /Language 🔒 Erfordert Authentifizierung

Sprachverwaltung

Lädt oder setzt die Sprache (JWT erforderlich).

GET: Gibt die aktuelle Sprache zurück.
POST: Setzt die Sprache (language: 0=de, 1=en, 2=fr, 3=cz, 4=es, 5=it).

Body (JSON) für POST:

{
   "language": 0
}

cURL Beispiel (POST):

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/Language \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"language":0}'

Python Beispiel (POST):

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
data = {"language": 0}  # 0 = Deutsch
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/Language", headers=headers, json=data)
print(r.json())

GET /health

API Gesundheitsprüfung

API Gesundheitsprüfung.

Antwort:

{
   "status": "healthy",
   "service": "myweb"
}

cURL Beispiel:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/health

Python Beispiel:

import requests
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/health")
print(r.json())

POST /checked

Benutzerverifizierung

Verifiziert und aktiviert Benutzer per E-Mail (Admin-Funktion). Falls der Benutzer nicht gefunden wird oder die E-Mail nicht identisch ist, erscheint eine Fehlermeldung.

Body (JSON):

{
   "email": "benutzer@example.com"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/checked \
-H "Content-Type: application/json" \
-d '{"email":"benutzer@example.com"}'

Python Beispiel:

import requests
data = {"email": "benutzer@example.com"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/checked", json=data)
print(r.json())

GET /configall 🔒 Erfordert Authentifizierung

Alle Konfigurationswerte abrufen

Ruft alle Konfigurationswerte ab (JWT erforderlich). Wird selten verwendet, da alle Konfigurationswerte automatisch gelesen und gespeichert werden.

cURL Beispiel:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configall \
-H "Authorization: Bearer <access_token>"

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configall", headers=headers)
print(r.json())

GET /config/<name> 🔒 Erfordert Authentifizierung

Spezifischen Konfigurationswert abrufen

Ruft spezifischen Konfigurationswert ab (JWT erforderlich). Der Name des Konfigurationswertes kann nur über das Web-Interface eingesehen werden.

cURL Beispiel:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/config/Language \
-H "Authorization: Bearer <access_token>"

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>"}
config_name = "Language"
r = requests.get(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/config/{config_name}", headers=headers)
print(r.json())

POST /configstring/<name> 🔒 Erfordert Authentifizierung

Konfigurationszeichenwert setzen

Setzt einen Konfigurationszeichenwert (JWT erforderlich). Speichert den Wert als String.

Body (JSON):

{
   "value": "CSV"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configstring/OutputFormat \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"value":"CSV"}'

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
config_name = "OutputFormat"
data = {"value": "CSV"}
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configstring/{config_name}", headers=headers, json=data)
print(r.json())

POST /configint/<name> 🔒 Erfordert Authentifizierung

Konfigurationszahlenwert setzen

Setzt einen Konfigurationszahlenwert (JWT erforderlich). Speichert den Wert als Ganzzahl.

Body (JSON):

{
   "value": 1000
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configint/NumberRecords \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"value":1000}'

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
config_name = "NumberRecords"
data = {"value": 1000}
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configint/{config_name}", headers=headers, json=data)
print(r.json())

POST /configbool/<name> 🔒 Erfordert Authentifizierung

Konfigurationswahrheitswert setzen

Setzt einen Konfigurationswahrheitswert (JWT erforderlich). Speichert den Wert als "Bool".

Body (JSON):

{
   "value": "true"
}

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configbool/JSONArray \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"value":"true"}'

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>", "Content-Type": "application/json"}
config_name = "JSONArray"
data = {"value": "true"}
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/configbool/{config_name}", headers=headers, json=data)
print(r.json())

POST /countryadd/<value> 🔒 Erfordert Authentifizierung

Land hinzufügen

Fügt ein Land zum Benutzerprofil hinzu (JWT erforderlich). Land hinzufügen. Nur eine bestimmte Anzahl von Ländern kann hinzugefügt werden, je nach Lizenz.

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countryadd/FR \
-H "Authorization: Bearer <access_token>"

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>"}
country_code = "FR"
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countryadd/{country_code}", headers=headers)
print(r.json())

POST /countrydel/<value> 🔒 Erfordert Authentifizierung

Land entfernen

Entfernt ein Land aus dem Benutzerprofil (JWT erforderlich).

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countrydel/FR \
-H "Authorization: Bearer <access_token>"

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>"}
country_code = "FR"
r = requests.post(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/countrydel/{country_code}", headers=headers)
print(r.json())

POST /init 🔒 Erfordert Authentifizierung

Konfiguration initialisieren

Initialisiert die Konfiguration (JWT erforderlich). Initialisiert die gesamte Konfigurationsdatei neu.

cURL Beispiel:

curl -X POST http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/init \
-H "Authorization: Bearer <access_token>"

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/init", headers=headers)
print(r.json())

GET /test 🔒 Erfordert Authentifizierung

Test-Endpunkt

Test-Endpunkt (JWT erforderlich).

cURL Beispiel:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/test \
-H "Authorization: Bearer <access_token>"

Python Beispiel:

import requests
headers = {"Authorization": "Bearer <access_token>"}
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/test", headers=headers)
print(r.json())

GET /running

API-Ausführungsstatus

Überprüft, ob die API läuft.

cURL Beispiel:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/running

Python Beispiel:

import requests
r = requests.get("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/running")
print(r.json())

GET /docs/<language>

API-Dokumentation

Ruft die API-Dokumentation in der angegebenen Sprache ab.

Unterstützte Sprachen: en, de, fr, cz

cURL Beispiel:

curl -X GET http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/docs/de

Python Beispiel:

import requests
language = "de"
r = requests.get(f"http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/docs/{language}")
print(r.text)

🔐 JWT-Token Verwendung

Für alle geschützten Endpunkte:

Lesen Sie den access_token nach dem Login aus.
Fügen Sie ihn in den Header ein:

Authorization: Bearer <access_token>

🚨 Fehlerbehandlung

Fehlerantwortformat

Alle Endpunkte geben JSON mit status ≠ 200 und einer aussagekräftigen message bei Fehlern zurück.

Häufige HTTP-Statuscodes

Statuscode	Beschreibung	Beispielantwort
`400`	Ungültige Anfrage	`{"status": 400, "message": "Erforderliche Parameter fehlen"}`
`401`	Nicht autorisiert	`{"status": 401, "message": "Ungültige oder fehlende Authentifizierung"}`
`403`	Verboten	`{"status": 403, "message": "Unzureichende Berechtigungen (Admin erforderlich)"}`
`404`	Nicht gefunden	`{"status": 404, "message": "Ressource nicht gefunden"}`
`500`	Interner Serverfehler	`{"status": 500, "message": "Server-seitiger Fehler"}`

Best Practices für Fehlerbehandlung

Prüfen Sie immer das status-Feld in Antworten
Behandeln Sie Authentifizierungsfehler durch Weiterleitung zur Anmeldung
Implementieren Sie Wiederholungslogik für temporäre Serverfehler (5xx)
Protokollieren Sie Fehlerdetails für Debugging-Zwecke
Zeigen Sie benutzerfreundliche Fehlermeldungen basierend auf Statuscodes

Beispiel für Fehlerbehandlung in Python:

import requests

def handle_api_response(response):
    try:
        data = response.json()
        if data.get("status") == 200:
            return data
        else:
            print(f"API-Fehler: {data.get('message', 'Unbekannter Fehler')}")
            return None
    except requests.exceptions.JSONDecodeError:
        print(f"HTTP-Fehler {response.status_code}: {response.text}")
        return None

# Verwendungsbeispiel
response = requests.post("http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io/login", json={"username": "test", "password": "test"})
result = handle_api_response(response)
if result:
    access_token = result.get("access_token")
    print("Anmeldung erfolgreich!")
else:
    print("Anmeldung fehlgeschlagen!")

📋 Zusätzliche Informationen

✅ Best Practices

Alle Daten werden als JSON gesendet und empfangen
Die API ist für moderne Web- und Mobile-Clients optimiert
Setzen Sie immer den Content-Type: application/json Header für alle POST-Anfragen
Speichern Sie JWT-Token sicher und erneuern Sie sie nach Ablauf
Verwenden Sie HTTPS in Produktionsumgebungen
Implementieren Sie ordnungsgemäße Fehlerbehandlung in Anwendungen
Respektieren Sie Rate-Limits für reibungslosen Betrieb

Sprachcodes

Code	Sprache
`0`	Deutsch
`1`	Englisch
`2`	Französisch
`3`	Tschechisch
`4`	Spanisch
`5`	Italienisch

🛠️ Kontakt und Support

Benötigen Sie Hilfe?

Bei Problemen oder Fragen:

Support-E-Mail: info@realtestdata.com
Python-Beispiel: Schauen Sie sich das mitgelieferte Python-Beispiel an: RealTestData_API_Generate.py
JavaScript-Beispiel: Ebenfalls verfügbar: RealTestData_API_Generate.js
Web-Interface: Verwenden Sie die Webversion unter http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io oder http:/rtdweb.proudglacier-6fd951f3.westeurope.azurecontainerapps.io:8001

Einrichtungsanleitung

Schnelle Schritte zum Einstieg

Python installieren: Laden Sie Python herunter und installieren es, um die API-Beispiele auszuprobieren
Registrierung: Verwenden Sie den /register Endpunkt, um ein Konto zu erstellen
Aktivierung: Überprüfen Sie Ihre E-Mail und aktivieren Sie das Konto
Anmeldung: Erhalten Sie einen JWT-Token über /login
Daten generieren: Verwenden Sie /generate_live für sofortige Ergebnisse
Konfiguration: Passen Sie Einstellungen über die Konfigurations-Endpunkte an

API-Test-Tools

Empfohlene Tools

Postman: Verwenden Sie die bereitgestellten Postman-Beispiele
cURL: Testen Sie von der Kommandozeile mit den bereitgestellten cURL-Beispielen
Python: Führen Sie das mitgelieferte RealTestData_API_Generate.py aus
JavaScript: Verwenden Sie RealTestData_API_Generate.js für Webanwendungen
Web-Interface: Testen Sie Funktionalitäten über das eingebaute Web-Interface

⚠️ Wichtige Hinweise

Lizenz erforderlich: Die meisten Funktionen erfordern eine gültige Lizenz
Länderbeschränkungen: Die Anzahl verfügbarer Länder hängt von Ihrer Lizenzstufe ab
Rate-Limits: API-Aufrufe können je nach Abonnement beschränkt sein
Token-Ablauf: JWT-Token haben eine Ablaufzeit, handhaben Sie dies entsprechend
E-Mail-Verifizierung: Kontoaktivierung erfordert E-Mail-Verifizierung

🎉 Bereit zum Loslegen!

Sie können diese Dokumentation direkt für Ihr Frontend, Tests oder Integrationen verwenden.

Alle Beispiele sind ausführbar und können leicht angepasst werden! Die API enthält umfassende Beispiele in mehreren Programmiersprachen.

Viel Spaß beim Programmieren mit der RealTestData API! 🚀