API v1 Quickstart

API v1 Quickstart

Diese Kurzanleitung zeigt dir die wichtigsten API-v1-Endpunkte in SEOFUXX und den schnellen Einstieg für Tests.

Basis

  • Basis-URL: https://www.seofuxx.com/api/v1
  • API-Spezifikation: openapi.yaml im Projekt
  • Viele Endpunkte erwarten application/x-www-form-urlencoded

Wichtige Endpunkte (neu/aktuell)

  • POST /account – Konto-Stammdaten/Profilaktionen
  • POST /password – Passwort aktualisieren
  • POST /domains-projekte – Domain, Keywords, AutoCrawl speichern
  • POST /filemerger – Analyse/Merge von CSS/JS
  • POST /favicon – Favicons aus Upload erzeugen
  • POST /favicon/ai-image – KI-Bild erzeugen
  • POST /favicon/from-ai – Favicons aus KI-Bild erzeugen
  • POST /sitemap – Sitemap generieren

Beispiel: Sitemap generieren

curl -X POST "https://www.seofuxx.com/api/v1/sitemap" \
  -d "domain=https://example.com" \
  -d "max_urls=500" \
  -d "max_depth=5"

Beispiel: Filemerger analysieren

curl -X POST "https://www.seofuxx.com/api/v1/filemerger" \
  -d "action=analyze" \
  -d "domain=https://example.com"

Beispiel: Filemerger mergen

curl -X POST "https://www.seofuxx.com/api/v1/filemerger" \
  -d "action=merge" \
  -d "domain=https://example.com" \
  -d "jsfiles[]=/assets/js/app.js" \
  -d "cssfiles[]=/assets/css/app.css" \
  -d "shrink=1"

Hinweise zur Authentifizierung

Einige Endpunkte sind an eine aktive Session (eingeloggter User) gebunden, z.B. account, password, domains-projekte.

Fehlerbilder

  • 400 – ungültige oder fehlende Parameter
  • 401 – nicht authentifiziert
  • 403 – Zugriff nicht erlaubt
  • 500 – interner Fehler oder Session fehlt

Empfehlung

Für eine vollständige Feldliste und Antwortschemas immer die openapi.yaml im Projekt verwenden.

Wiki-Version 1.05