API v1 Quickstart

Hier vind je de belangrijkste endpoints van de SEOFuxx API v1 en een paar voorbeelden waarmee je snel kunt testen.

Basis

• Basis-URL: https://www.seofuxx.com/api/v1
• De specificatie staat als openapi.yaml in het project
• Veel endpoints verwachten application/x-www-form-urlencoded

De belangrijkste endpoints

• POST /account: accountgegevens en profielacties
• POST /password: wachtwoord bijwerken
• POST /domains-projekte: domein, zoekwoorden en Auto Crawl opslaan
• POST /filemerger: CSS/JS analyseren of samenvoegen
• POST /favicon: favicons genereren uit een upload
• POST /favicon/ai-image: AI-afbeelding genereren
• POST /favicon/from-ai: favicons genereren uit een AI-afbeelding
• GET /ai-visibility: AI Visibility-cijfers lezen (met API-sleutel)
• POST /api-keys: API-sleutels aanmaken, tonen en intrekken

Voorbeeld: File Merger analyseren

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

Voorbeeld: File Merger samenvoegen

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"

Authenticatie

De meeste endpoints hangen aan een actieve sessie, je moet dus ingelogd zijn. Dat geldt bijvoorbeeld voor account, password, domains-projekte en filemerger. De voorbeelden hierboven werken daarom alleen met de cookie van een ingelogde sessie.

Voor geautomatiseerde aanvragen zijn er API-sleutels. Die maak je aan in je account op het tabblad API-sleutels. De sleutel wordt maar één keer in leesbare tekst getoond, kopieer hem dus meteen. Raak je hem kwijt of vermoed je misbruik, dan trek je hem daar weer in. Met de sleutel stuur je de header Authorization: Bearer sfx_..., bijvoorbeeld naar GET /ai-visibility (zie AI Visibility Tracking) en naar het MCP-endpoint.

Foutcodes

• 400: ongeldige of ontbrekende parameters
• 401: niet ingelogd
• 403: toegang niet toegestaan
• 429: limiet bereikt, bijvoorbeeld bij analyses zonder account
• 500: interne fout

Alle velden en de antwoordschema's staan volledig in de openapi.yaml, kijk voor details het beste daar.