API-Zugang & Programmatisches Testen

Integrieren Sie Barrierefreiheitstests direkt in Ihre Entwicklungspipeline mit unserem API-Zugang.

Was ist ein API-Zugang?

Mit einem API-Zugang erhalten Sie einen persönlichen API-Schlüssel, der Ihnen erweiterte Funktionen für die automatisierte Barrierefreiheitsprüfung ermöglicht. Dies ist besonders nützlich für:

  • Automatisierte Tests in CI/CD-Pipelines (GitLab, GitHub Actions, Jenkins)
  • Regelmäßige Überwachung mehrerer Websites oder Seiten
  • Integration in bestehende Entwicklungswerkzeuge
  • Batch-Verarbeitung von URLs für umfassende Audits
  • KI-gestützte semantische Barrierefreiheitsanalyse (optional)

Vorteile des API-Zugangs

Höhere Rate Limits

Ohne API-Schlüssel (anonym): 10 Audits pro IP-Adresse und Tag, davon 3 mit KI-Analyse

Mit API-Schlüssel: Standardmäßig 100 Audits pro Tag (individuell anpassbar)

Erweiterte Funktionen

  • Webhook-Benachrichtigungen bei Abschluss der Prüfung
  • Batch-Verarbeitung mehrerer URLs gleichzeitig
  • Zugriff auf detaillierte API-Dokumentation (OpenAPI/Swagger)
  • KI-gestützte Analyse (optional zubuchbar) – siehe Abschnitt unten

Programmatische Nutzung

Vollständige REST-API mit JSON-Antworten für einfache Integration in beliebige Programmiersprachen und Tools.

curl -X POST https://barrieretest.at/v1/audit \
  -H "Authorization: Bearer IHR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com"]}'

Datenschutz: Unterschiede zwischen anonymer und API-Schlüssel-Nutzung

AspektAnonyme NutzungMit API-Schlüssel
PersonenbezugKeine persönlichen Daten erfasstAPI-Schlüssel kann optional mit E-Mail-Adresse verknüpft werden
Speicherung IP-Adresse30 Tage (für Rate Limiting)30 Tage (zur Missbrauchsprävention)
Audit-Ergebnisse90 Tage gespeichert90 Tage gespeichert, verknüpft mit API-Schlüssel
Zugriff auf eigene DatenNur über Audit-ID möglichAlle eigenen Audits über API abrufbar
DatenverarbeitungNur pa11y-Analyse (lokale Verarbeitung)pa11y-Analyse + optional KI-Analyse (externe Verarbeitung, siehe unten)
RechtsgrundlageBerechtigtes Interesse (Art. 6 Abs. 1 lit. f DSGVO)Vertragserfüllung (Art. 6 Abs. 1 lit. b DSGVO)
LöschungAutomatisch nach 90 Tagen oder auf Anfrage über Audit-IDAutomatisch nach 90 Tagen oder jederzeit über API löschbar

Wichtig: Die vollständige Datenschutzerklärung mit allen Details zur Datenverarbeitung finden Sie auf unserer Datenschutzseite. Für API-Nutzer gelten zusätzlich die in den folgenden Abschnitten beschriebenen Verarbeitungen.

KI-gestützte Barrierefreiheitsanalyse

Was macht die KI?

Die optionale KI-Analyse ergänzt die automatisierten technischen Tests von pa11y um semantische Prüfungen, die menschliches Verständnis erfordern. Während pa11y WCAG-Regelverstöße erkennt (z.B. fehlendes alt-Attribut), bewertet die KI die Qualität und Sinnhaftigkeit der Barrierefreiheits-Implementierung.

Die KI prüft folgende 6 Aspekte:

1.
ARIA-Label-Übereinstimmung

Prüft, ob aria-label-Texte mit dem visuellen Inhalt übereinstimmen (z.B. Button zeigt "Absenden", aber aria-label sagt "Hier klicken")

2.
Seitentitel-Qualität

Bewertet, ob der Seitentitel beschreibend, eindeutig und aussagekräftig ist

3.
Alt-Text-Sinnhaftigkeit

Prüft, ob Alternativtexte für Bilder wirklich aussagekräftig sind (nicht nur vorhanden, sondern nützlich)

4.
Formular-Label-Klarheit

Bewertet, ob Formularlabels klar, verständlich und ausreichend beschreibend sind

5.
Sprachangabe-Übereinstimmung

Überprüft, ob das lang-Attribut mit der tatsächlichen Sprache des Seiteninhalts übereinstimmt

6.
Landmark-Regionen

Identifiziert und bewertet ARIA-Landmarks zur Strukturierung der Seite (main, navigation, etc.)

Wann und wo wird die KI eingesetzt?

🔒

Opt-in: Die KI-Analyse ist optional und muss explizit aktiviert werden über den Parameter enableAI: true im API-Request.

🔑

Nur für API-Schlüssel-Nutzer: KI-Analysen sind ausschließlich für authentifizierte Nutzer mit gültigem API-Schlüssel verfügbar. Anonyme Nutzer erhalten nur pa11y-Ergebnisse.

Parallele Verarbeitung: Die KI-Analyse läuft parallel zur pa11y-Prüfung, um die Gesamtdauer zu minimieren. Bei Ausfall der KI-Analyse werden weiterhin die pa11y-Ergebnisse zurückgegeben (graceful degradation).

🖼️

Daten, die zur KI gesendet werden:

  • Screenshot der Webseite (PNG, base64-codiert)
  • HTML-Struktur der Seite (erste 5.000 Zeichen)
  • ARIA-Attribute und Landmark-Elemente
  • Formulare, Bilder und deren Alternativtexte
  • Seitentitel und Sprachangaben

Auftragsverarbeiter und Unterauftragsverarbeiter

Datenverarbeitungskette

Sie (Verantwortlicher)
barrieretest.at (Auftragsverarbeiter)
Nebius AI (Unterauftragsverarbeiter)
barrieretest.at (Solasit e.U.)
Rolle: Auftragsverarbeiter (Art. 28 DSGVO)
Standort: Österreich (EU)
Verarbeitung:
  • Speicherung von URLs und Audit-Ergebnissen
  • Ausführung von pa11y-Tests (lokal)
  • Koordination und Weiterleitung von KI-Anfragen
  • Bereitstellung der API-Infrastruktur
Datenschutz: DSGVO-konform, Hosting in der EU
Nebius AI (Nebius B.V.)
Rolle: Unterauftragsverarbeiter
Standort: Niederlande (EU)
Verarbeitung:
  • KI-gestützte Analyse von Screenshots und HTML-Inhalten
  • Verwendung von Large Language Models (LLMs)
  • Rückgabe strukturierter Analyseergebnisse
Modell: Meta Llama 3.1 8B Instruct (Open Source)
Datenspeicherung: Keine dauerhafte Speicherung der Eingabedaten laut Nebius AGB
Datenschutz: DSGVO-konform, EU-Hosting
Website: nebius.ai
Datenfluss bei KI-Analyse
  1. Sie senden einen API-Request mit enableAI: true an barrieretest.at
  2. barrieretest.at erstellt einen Screenshot und extrahiert HTML-Strukturen der zu prüfenden Seite
  3. Diese Daten werden an Nebius AI gesendet (Screenshot als base64, HTML-Kontext als Text)
  4. Nebius AI analysiert die Daten mit dem LLM und gibt strukturierte Ergebnisse zurück
  5. barrieretest.at empfängt die Ergebnisse, kombiniert sie mit pa11y-Daten und speichert sie in der Datenbank
  6. Sie erhalten die kombinierten Ergebnisse über die API
⚠️ Wichtige Hinweise zur KI-Verarbeitung
  • • Die KI-Analyse erfolgt ausschließlich bei expliziter Aktivierung durch Sie
  • • Sensible Daten oder personenbezogene Informationen sollten nicht auf den zu prüfenden Seiten sichtbar sein
  • • Die Datenübertragung erfolgt verschlüsselt (HTTPS/TLS)
  • • Nebius AI speichert die Eingabedaten nicht dauerhaft (nur für die Verarbeitung)
  • • Sie bleiben Verantwortlicher im Sinne der DSGVO für die von Ihnen zur Prüfung übermittelten URLs

API-Dokumentation (OpenAPI/Swagger)

Die vollständige, interaktive API-Dokumentation steht Ihnen über unsere OpenAPI-Spezifikation zur Verfügung. Dort finden Sie:

  • Alle verfügbaren Endpunkte und deren Parameter
  • Request- und Response-Schemas mit Beispielen
  • Authentifizierungsdetails (Bearer Token)
  • Interaktive API-Tests direkt im Browser
  • Code-Beispiele für verschiedene Programmiersprachen

Interaktive API-Dokumentation

Testen Sie die API direkt im Browser mit unserem Swagger-Interface:

Zur API-Dokumentation

OpenAPI-Spezifikation herunterladen

Für die Integration in Ihre Tools (z.B. Postman, Insomnia) können Sie die OpenAPI-JSON-Datei direkt herunterladen:

openapi.json herunterladen

API-Zugang beantragen

Interessiert an einem API-Schlüssel für automatisierte Barrierefreiheitstests? Kontaktieren Sie uns für ein individuelles Angebot.

Kontaktmöglichkeiten

Informationen, die wir benötigen

  • Geplante monatliche Anzahl an Audits
  • Verwendungszweck (CI/CD, Monitoring, Batch-Verarbeitung, etc.)
  • Interesse an KI-gestützter Analyse (optional)
  • Ihre Kontaktdaten und Firmendaten

Letzte Aktualisierung: 11.12.2025 Datenschutzerklärung Impressum