Inicio rápido de la API v1

Aquí tienes los endpoints más importantes de la API v1 de SEOFuxx y unos cuantos ejemplos para empezar a probar enseguida.

Conceptos básicos

• URL base: https://www.seofuxx.com/api/v1
• La especificación es el archivo openapi.yaml del proyecto
• Muchos endpoints esperan application/x-www-form-urlencoded

Los endpoints principales

• POST /account: datos de la cuenta y acciones de perfil
• POST /password: actualizar la contraseña
• POST /domains-projekte: guardar dominio, palabras clave y Auto Crawl
• POST /filemerger: analizar o combinar CSS/JS
• POST /favicon: generar favicons a partir de una subida
• POST /favicon/ai-image: generar una imagen con IA
• POST /favicon/from-ai: generar favicons a partir de una imagen de IA
• GET /ai-visibility: leer las cifras de AI Visibility (con clave API)
• POST /api-keys: crear, listar y revocar claves API

Ejemplo: analizar con el File Merger

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

Ejemplo: combinar con el File Merger

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"

Autenticación

La mayoría de los endpoints dependen de una sesión activa, así que tienes que haber iniciado sesión. Es el caso de account, password, domains-projekte y filemerger, por ejemplo. Los ejemplos de arriba solo funcionan, por tanto, con la cookie de una sesión iniciada.

Para consultas automáticas existen las claves API. Las creas en tu cuenta, en la pestaña Claves API. La clave se muestra en texto plano una sola vez, así que cópiala enseguida. Si la pierdes o sospechas un uso indebido, la revocas ahí mismo. Con la clave envías la cabecera Authorization: Bearer sfx_..., por ejemplo a GET /ai-visibility (consulta AI Visibility Tracking) y al endpoint MCP.

Códigos de error

• 400: parámetros no válidos o ausentes
• 401: sin sesión iniciada
• 403: acceso no permitido
• 429: límite alcanzado, por ejemplo en análisis sin cuenta
• 500: error interno

La lista completa de campos y los esquemas de respuesta estan en el openapi.yaml, para los detalles mejor mira ahí.