API v1: guida rapida

Qui trovi gli endpoint più importanti dell'API v1 di SEOFuxx e alcuni esempi con cui provare subito.

Base

• URL di base: https://www.seofuxx.com/api/v1
• La specifica è nel progetto come openapi.yaml
• Molti endpoint si aspettano application/x-www-form-urlencoded

Gli endpoint più importanti

• POST /account: dati anagrafici e azioni sul profilo
• POST /password: aggiornare la password
• POST /domains-projekte: salvare dominio, parole chiave e Auto Crawl
• POST /filemerger: analizzare o unire file CSS/JS
• POST /favicon: generare favicon da un file caricato
• POST /favicon/ai-image: generare un'immagine con l'IA
• POST /favicon/from-ai: generare favicon da un'immagine IA
• GET /ai-visibility: leggere le metriche di AI Visibility (con chiave API)
• POST /api-keys: creare, elencare e revocare chiavi API

Esempio: analizzare con Filemerger

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

Esempio: unire con Filemerger

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"

Autenticazione

La maggior parte degli endpoint dipende da una sessione attiva, quindi devi aver effettuato l'accesso. Vale ad esempio per account, password, domains-projekte e filemerger. Gli esempi qui sopra funzionano quindi solo con il cookie di una sessione autenticata.

Per le richieste automatiche esistono le chiavi API. Le crei nell'Account, nella scheda Chiavi API. La chiave viene mostrata in chiaro una sola volta, quindi copiala subito. Se la perdi o sospetti un uso improprio, la revochi lì stesso. Con la chiave invii l'header Authorization: Bearer sfx_..., ad esempio a GET /ai-visibility (vedi AI Visibility Tracking) e all'endpoint MCP.

Codici di errore

• 400: parametri non validi o mancanti
• 401: accesso non effettuato
• 403: accesso non consentito
• 429: limite raggiunto, ad esempio per analisi senza account
• 500: errore interno

Tutti i campi e gli schemi di risposta sono riportati per intero in openapi.yaml: per i dettagli conviene guardare lì.