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
| Aspekt | Anonyme Nutzung | Mit API-Schlüssel |
|---|---|---|
| Personenbezug | Keine persönlichen Daten erfasst | API-Schlüssel kann optional mit E-Mail-Adresse verknüpft werden |
| Speicherung IP-Adresse | 30 Tage (für Rate Limiting) | 30 Tage (zur Missbrauchsprävention) |
| Audit-Ergebnisse | 90 Tage gespeichert | 90 Tage gespeichert, verknüpft mit API-Schlüssel |
| Zugriff auf eigene Daten | Nur über Audit-ID möglich | Alle eigenen Audits über API abrufbar |
| Datenverarbeitung | Nur pa11y-Analyse (lokale Verarbeitung) | pa11y-Analyse + optional KI-Analyse (externe Verarbeitung, siehe unten) |
| Rechtsgrundlage | Berechtigtes Interesse (Art. 6 Abs. 1 lit. f DSGVO) | Vertragserfüllung (Art. 6 Abs. 1 lit. b DSGVO) |
| Löschung | Automatisch nach 90 Tagen oder auf Anfrage über Audit-ID | Automatisch 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:
Prüft, ob aria-label-Texte mit dem visuellen Inhalt übereinstimmen (z.B. Button zeigt "Absenden", aber aria-label sagt "Hier klicken")
Bewertet, ob der Seitentitel beschreibend, eindeutig und aussagekräftig ist
Prüft, ob Alternativtexte für Bilder wirklich aussagekräftig sind (nicht nur vorhanden, sondern nützlich)
Bewertet, ob Formularlabels klar, verständlich und ausreichend beschreibend sind
Überprüft, ob das lang-Attribut mit der tatsächlichen Sprache des Seiteninhalts übereinstimmt
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
barrieretest.at (Solasit e.U.)
- Speicherung von URLs und Audit-Ergebnissen
- Ausführung von pa11y-Tests (lokal)
- Koordination und Weiterleitung von KI-Anfragen
- Bereitstellung der API-Infrastruktur
Nebius AI (Nebius B.V.)
- KI-gestützte Analyse von Screenshots und HTML-Inhalten
- Verwendung von Large Language Models (LLMs)
- Rückgabe strukturierter Analyseergebnisse
Datenfluss bei KI-Analyse
- Sie senden einen API-Request mit
enableAI: truean barrieretest.at - barrieretest.at erstellt einen Screenshot und extrahiert HTML-Strukturen der zu prüfenden Seite
- Diese Daten werden an Nebius AI gesendet (Screenshot als base64, HTML-Kontext als Text)
- Nebius AI analysiert die Daten mit dem LLM und gibt strukturierte Ergebnisse zurück
- barrieretest.at empfängt die Ergebnisse, kombiniert sie mit pa11y-Daten und speichert sie in der Datenbank
- 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-DokumentationOpenAPI-Spezifikation herunterladen
Für die Integration in Ihre Tools (z.B. Postman, Insomnia) können Sie die OpenAPI-JSON-Datei direkt herunterladen:
openapi.json herunterladenAPI-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