„axe DevTools Mobile API“
Die axe DevTools Mobile API (Application Program Interface) ist um den Representational State Transfer herum organisiert, der oft als REST bezeichnet wird.
Nutzen Sie unsere API und kontrollieren Sie den Workflow Ihres Teams beim Testen der Barrierefreiheit vollständig.
Springe zu:
- Authentifizierung
- Scan-Zusammenfassungen
- Gefilterte Scan-Zusammenfassungen
- Einen Scan abrufen
- Einen Scan senden
- Aktualisieren des Namens eines Scans
- Update a Scan's Tag(s)
- Löschen eines Scans
Verweise auf {{result_userid}, {{result_package} oder {{result_id} können nach Abschluss eines Scans innerhalb von AxeDevToolsResultKey
Objekten von axe DevTools Mobile gefunden werden.
Authentifizierung
Um zu beginnen, kopieren oder erstellen Sie einen neuen API-Schlüssel unter axe.deque.com/settings.
Fügen Sie bei jeder Anfrage Ihren API-Schlüssel zum Header hinzu:
Taste | Wert |
---|---|
X-Api-Key | YOUR_API_KEY |
Scan-Zusammenfassungen
Ruft eine zusammengefasste Ergebnisliste vom Server ab.
Anfrage
URL: https://axe-mobile-backend.deque.com/attest/results/summaries
Kopfdaten:
Taste | Wert |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Antwort
Gibt ein Array mit Ergebniszusammenfassungen zurück.
Beispiel-JSON
[
{
"key": {
"userId": "",
"packageName": "",
"resultId": "",
"uuid": ""
},
"userName": "",
"summary": {
"MeaningfulAccessibleName": {
"PASS": 10,
"FAIL": 1
},
"A11yElementFocusBox": {
"PASS": 10
},
"ConflictingTraits": {
"PASS": 10
}
},
"tags": [
""
],
"axeDevice": {
"dpi": 2.0,
"name": "iPhone 8",
"os": "iOS",
"osVersion": "13.7",
"screenHeight": 1334,
"screenWidth": 750
},
"axeMetaData": {
"axeVersion": "XCUI: 2.0.1-647-f49682f0",
"appIdentifier": "",
"analysisTimestamp": "",
"screenTitle": ""
},
"scanName": "",
"uuid": "",
}
]
Gefilterte Scan-Zusammenfassungen
Ruft vom Server eine zusammengefasste Liste mit Ergebnissen ab, die den angegebenen Kriterien entsprechen.
Anfrage
URL: https://axe-mobile-backend.deque.com/attest/results/summaries
Kopfdaten:
Taste | Wert |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | Anwendung/Json |
Abfrageparameter:
Taste | Wert |
---|---|
userId | Zeichenfolge |
os | Zeichenfolge |
tags | String (durch Komma getrennt) |
packageName | String |
Antwort
Gibt ein Array mit Ergebniszusammenfassungen zurück.
Beispiel-JSON
[
{
"key": {
"userId": "",
"packageName": "",
"resultId": "",
"uuid": ""
},
"userName": "",
"summary": {
"MeaningfulAccessibleName": {
"PASS": 10,
"FAIL": 1
},
"A11yElementFocusBox": {
"PASS": 10
},
"ConflictingTraits": {
"PASS": 10
}
},
"tags": [
""
],
"axeDevice": {
"dpi": 2.0,
"name": "iPhone 8",
"os": "iOS",
"osVersion": "13.7",
"screenHeight": 1334,
"screenWidth": 750
},
"axeMetaData": {
"axeVersion": "XCUI: 2.0.1-647-f49682f0",
"appIdentifier": "",
"analysisTimestamp": "",
"screenTitle": ""
},
"scanName": "",
"uuid":"",
}
]
Einen Scan abrufen
Gibt ein bestimmtes Scan-Ergebnis vom Dashboard zurück.
Anfrage
URL: https://axe-mobile-backend.deque.com/attest/result/axe/{{result_userid}}/{{result_package}}/{{result_id}}
Kopfdaten:
Taste | Wert |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Antwort
Gibt ein Scan-Ergebnis zurück.
Beispiel-JSON
Hinweis: `axeView` enthält unterschiedliche plattformspezifische Eigenschaften für einen iOS- oder Android-Scan.
{
"axeConf": {
"standards": [
"Best Practice",
"Platform",
"WCAG 2.0",
"WCAG 2.1"
],
"ruleIds": [
"SwitchName",
"ActiveViewName"
],
"rules": {
"SwitchName": {
"impact": 1,
"standard": "Best Practice",
"summary": "Views that have modifiable Values
should get their name from a nearby Label.",
"ignored": false
},
"ActiveViewName": {
"impact": 3,
"standard": "WCAG 2.0",
"summary": "Views that users can interact with must
have a Name.",
"ignored": false
}
},
"issueFilterConf": {
"onlyShowResultsVisibleToUser": false
}
},
"axeContext": {
"axeView": {
"isComposeView": false,
"isImportantForAccessibility": true,
"visibility": 0.0,
"axeViewId": "",
"measuredWidth": 1080.0,
"className": "",
"textColor": "0",
"boundsInScreen": {
"bottom": 2340.0,
"left": 0.0,
"right": 1080.0,
"top": 0.0
},
"isVisibleToUser": true,
"isAccessibilityFocusable": false,
"overridesAccessibilityDelegate": false,
"measuredHeight": 2340.0,
"children": [
{
"axeViewId": "",
"boundsInScreen": {
"bottom": 0.0,
"left": 0.0,
"right": 0.0,
"top": 0.0
},
"calculatedProps": {
...
},
"children": [
...
],
"className": "android.widget.LinearLayout",
"ignoreRules": [
"HiddenInformativeViewFocus",
"HiddenActiveViewFocus"
],
"isAccessibilityFocusable": false,
"isClickable": false,
"isComposeView": false,
"isEnabled": true,
"isImportantForAccessibility": false,
"isVisibleToUser": true,
"measuredHeight": 0.0,
"measuredWidth": 0.0,
"overridesAccessibilityDelegate": false,
"packageName": "",
"textColor": "0",
"viewIdResourceName": "",
"visibility": 0.0
},
...
],
"isEnabled": true,
"viewIdResourceName": "",
"calculatedProps": {
...
},
"isClickable": false,
"ignoreRules": [
""
],
"packageName": ""
},
"axeDevice": {
"dpi": 3.0,
"name": "",
"os": "Android",
"osVersion": "",
"screenHeight": 0,
"screenWidth": 0
},
"screenshot": "",
"axeEventStream": [],
"axeMetaData": {
"axeVersion": "",
"appIdentifier": "",
"analysisTimestamp": "",
"screenTitle": ""
}
},
"axeRuleResults": [
{
"axeViewId": "",
"isVisibleToUser": true,
"props": {
...
},
"ruleId": "",
"ruleSummary": "",
"impact": 4,
"status": "PASS"
},
...
],
"userName": "",
"scanName": "",
"tags": [
""
],
"uuid": "",
"score": 80
}
Einen Scan senden
Lädt ein Scan-Ergebnis zum Dashboard hoch.
Anfrage
URL: https://axe-mobile-backend.deque.com/attest/result/axe
Kopfdaten:
Taste | Wert |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Body:
JSON vom iOS- oder Android-Scan.
Antwort
Gibt den Ergebnisschlüssel des übermittelten Ergebnisses zurück.
Beispiel-JSON
{
"userId": "",
"packageName": "",
"resultId": "",
"uuid": ""
}
Aktualisieren des Namens eines Scans
Aktualisiert den Namen eines Scans, wie im Dashboard angezeigt.
Anfrage
URL: https://axe-mobile-backend.deque.com/attest/results/summaries/{{result_userid}}/{{result_package}}/{{result_id}}/name
Kopfdaten:
Taste | Wert |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Body:
Name of the Scan
Antwort
Gibt die Zusammenfassung der Scan-Ergebnisse zurück.
Beispiel-JSON
{
"key": {
"userId": "",
"packageName": "",
"resultId": "",
"uuid": ""
},
"userName": "",
"summary": {
"ActiveControlName": {
"PASS": 10
},
"A11yElementFocusBox": {
"PASS": 10,
"FAIL": 1
}
},
"tags": [
""
],
"axeDevice": {
"dpi": 3.0,
"name": "",
"os": "",
"osVersion": "",
"screenHeight": 0,
"screenWidth": 0
},
"axeMetaData": {
"axeVersion": "",
"appIdentifier": "",
"analysisTimestamp": "",
"screenTitle": ""
},
"scanName": "Name of the Scan"
}
Update a Scan's Tag(s)
Aktualisiert die Tags eines Scans, wie im Dashboard angezeigt, auf die angegebenen Tags.
Anfrage
URL: https://axe-mobile-backend.deque.com/attest/result/tag/{{result_userid}}/{{result_package}}/{{result_id}}
Kopfdaten:
Taste | Wert |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Body:
["Example Tag"]
Antwort
Gibt den Ergebnisschlüssel des aktualisierten Ergebnisses zurück.
Beispiel-JSON
{
"userId": "",
"packageName": "",
"resultId": "",
"uuid": ""
}
Löschen eines Scans
Entfernt ein Scan-Ergebnis aus dem Dashboard.
Anfrage
URL: https://axe-mobile-backend.deque.com/attest/result/{{result_userid}}/{{result_package}}/{{result_id}}
Kopfdaten:
Taste | Wert |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Antwort
Gibt den Ergebnisschlüssel des gelöschten Ergebnisses zurück.
Beispiel-JSON
{
"userId": "",
"packageName": "",
"resultId": "",
"uuid": ""
}