API de axe DevTools Mobile
La API de axe DevTools Mobile está organizada en torno a la transferencia de estado representacional, a menudo denominada REST.
Utilice nuestra API y controle completamente el flujo de trabajo de su equipo en las pruebas de accesibilidad.
Saltar a:
- Autenticación
- Resúmenes de escaneo
- Resúmenes de escaneo filtrados
- Obtener un escaneo
- Enviar un escaneo
- Actualizar el nombre de un escaneo
- Actualizar las etiquetas de un análisis
- Eliminar un escaneo
Se pueden encontrar referencias a [palabra] {{result_userid}}, [palabra] {{result_package}}, o [palabra] {{result_id}} dentro de los objetos AxeDevToolsResultKey
de axe DevTools Mobile después de que se complete un escaneo.
Autenticación
Para comenzar, copie o cree una nueva clave API en axe.deque.com/settings.
Para cualquier solicitud, agregue su clave API al encabezado:
Tecla | Valor |
---|---|
X-Api-Key | YOUR_API_KEY |
Resúmenes de escaneo
Recupera una lista resumida de resultados del servidor.
Petición
URL: https://axe-mobile-backend.deque.com/attest/results/summaries
Encabezados:
Tecla | Valor |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Respuesta
Devuelve un array de resúmenes de resultados.
Ejemplo 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": "",
}
]
Resúmenes de escaneo filtrados
Recupera una lista resumida de resultados del servidor que coinciden con los criterios especificados.
Petición
URL: https://axe-mobile-backend.deque.com/attest/results/summaries
Encabezados:
Tecla | Valor |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Parámetros de consulta:
Tecla | Valor |
---|---|
ID de usuario | Cadena |
os | Cadena |
etiquetas | Cadena (separada por comas) |
packageName | Cadena |
Respuesta
Devuelve un array de resúmenes de resultados.
Ejemplo 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":"",
}
]
Recuperar un escaneo
Devuelve un resultado de escaneo específico del panel de control.
Petición
URL: https://axe-mobile-backend.deque.com/attest/result/axe/{{result_userid}}/{{result_package}}/{{result_id}}
Encabezados:
Tecla | Valor |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Respuesta
Devuelve un resultado de escaneo.
Ejemplo JSON
Nota: `axeView` contendrá diferentes propiedades específicas de la plataforma para un escaneo de iOS o Android.
{
"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
}
Enviar una exploración
Sube un resultado de escaneo al panel de control.
Petición
URL: https://axe-mobile-backend.deque.com/attest/result/axe
Encabezados:
Tecla | Valor |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Cuerpo:
JSON de escaneo de iOS o Android.
Respuesta
Devuelve la clave de resultado del resultado enviado.
Ejemplo JSON
{
"userId": "",
"packageName": "",
"resultId": "",
"uuid": ""
}
Actualizar el nombre de un Análisis
Actualiza el nombre de un Análisis como se muestra en el panel de control.
Petición
URL: https://axe-mobile-backend.deque.com/attest/results/summaries/{{result_userid}}/{{result_package}}/{{result_id}}/name
Encabezados:
Tecla | Valor |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Cuerpo:
Name of the Scan
Respuesta
Devuelve el resumen del resultado del escaneo.
Ejemplo 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)
Actualiza las etiquetas de un escaneo como se muestran en el panel de control a las etiquetas especificadas.
Petición
URL: https://axe-mobile-backend.deque.com/attest/result/tag/{{result_userid}}/{{result_package}}/{{result_id}}
Encabezados:
Tecla | Valor |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Cuerpo:
["Example Tag"]
Respuesta
Devuelve la clave del resultado actualizado.
Ejemplo JSON
{
"userId": "",
"packageName": "",
"resultId": "",
"uuid": ""
}
Eliminar un escaneo
Elimina un resultado de escaneo del panel de control.
Petición
URL: https://axe-mobile-backend.deque.com/attest/result/{{result_userid}}/{{result_package}}/{{result_id}}
Encabezados:
Tecla | Valor |
---|---|
X-Api-Key | YOUR_API_KEY |
Content-Type | application/json |
Respuesta
Devuelve la clave de resultado del resultado eliminado.
Ejemplo JSON
{
"userId": "",
"packageName": "",
"resultId": "",
"uuid": ""
}