Zum Hauptinhalt springen
Die Seemodo API bietet programmatischen Zugriff auf alle KI-gestützten Code-Generierungs-, Sandbox-Verwaltungs- und Cloud-Integrations-Features.

Basis-URL

Alle API-Endpunkte sind relativ zu deiner Seemodo-Instanz:
https://deine-domain.com/api/
Für lokale Entwicklung:
http://app.seemodo.ai/api/

Authentifizierung

Die meisten Endpunkte erfordern keine Authentifizierung für lokale Entwicklung. Für Produktions-Deployments konfiguriere Authentifizierung via Umgebungsvariablen. Für Seemodo Cloud (Supabase) Endpunkte, inkludiere den Supabase API-Token im Header:
curl -X POST https://deine-domain.com/api/seemodo-cloud \
  -H "Content-Type: application/json" \
  -H "X-Supabase-Token: dein-supabase-token" \
  -d '{"action": "status", "projectRef": "deine-projekt-ref"}'

API-Kategorien

Anfrage-Format

Alle POST-Endpunkte akzeptieren JSON-Payloads:
curl -X POST https://deine-domain.com/api/generate-screen \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Ein modernes Dashboard mit Analyse-Charts",
    "width": 1280,
    "height": 800,
    "screenType": "Desktop"
  }'

Antwort-Format

Antworten sind JSON-Objekte mit konsistenter Struktur:
{
  "success": true,
  "data": { ... },
  "message": "Operation erfolgreich abgeschlossen"
}
Fehler-Antworten inkludieren Details:
{
  "success": false,
  "error": "Fehlermeldung",
  "details": "Zusätzlicher Fehler-Kontext"
}

Häufige Antwort-Codes

CodeBeschreibung
200Erfolg
400Ungültige Anfrage - fehlende oder ungültige Parameter
401Nicht autorisiert - fehlende oder ungültige Authentifizierung
404Nicht gefunden - Ressource existiert nicht
500Server-Fehler - Fehler-Details prüfen

Rate-Limiting

API-Aufrufe unterliegen Rate-Limiting basierend auf deinem Abonnement-Plan. Bei Rate-Limiting erhältst du einen 429 Status-Code. Warte und versuche nach der angegebenen Zeit erneut.

Verfügbare Endpunkte

Code-Generierung

EndpunktMethodeBeschreibung
/generate-screenPOSTEinzelnen Screen aus Prompt generieren
/generate-flowPOSTMehrere verbundene Screens generieren
/edit-screenPOSTBestehenden Screen bearbeiten
/enhance-promptPOSTPrompt für bessere Ergebnisse verbessern

Sandbox-Verwaltung

EndpunktMethodeBeschreibung
/create-ai-sandboxPOSTNeue Sandbox erstellen
/create-ai-sandbox-v2POSTSandbox mit Modal Backend erstellen
/sandbox-statusGETSandbox-Gesundheitsstatus prüfen
/get-sandbox-filesGETAlle Dateien in Sandbox auflisten
/kill-sandboxPOSTSandbox beenden
/restart-vitePOSTVite Dev-Server neustarten

Website-Klonen

EndpunktMethodeBeschreibung
/scrape-websitePOSTWebsite-Inhalt und Struktur scrapen
/scrape-url-enhancedPOSTErweitertes Scraping mit Screenshots
/scrape-screenshotPOSTWebsite-Screenshot aufnehmen

Seemodo Cloud

EndpunktMethodeBeschreibung
/seemodo-cloudPOSTSupabase-Integration verwalten
/supabase-proxy/**Anfragen an Supabase proxyen