Ir al contenido

Estado del trabajo

URL base https://api.accessful.de/api/v1/upload-service. Cada petición necesita la cabecera X-API-Key — consulta Autenticación.

GET /job-status/{caseId}

200 OK

{ "jobStatus": "completed", "stage": "finished", "score": 87 }

score es la calidad de accesibilidad del resultado, 0–100 (definitivo una vez completed). Se devuelve 404 para un caseId desconocido.

La respuesta tiene dos campos independientes: jobStatus es el resultado general —úsalo para decidir cuándo ha terminado el trabajo— mientras que stage es la fase detallada del pipeline de un caso en curso, indicando dónde se encuentra.

jobStatusSignificado
queuedEn espera en la cola.
runningProcesándose actualmente.
completedTerminado — resultado listo para descargar.final
failedEl procesamiento falló.final
analyzer_failedEl paso de análisis de accesibilidad falló.final
canceledEl trabajo fue cancelado.final
quota_pendingA la espera de una comprobación de cuota asíncrona.
quota_exceededRechazado — cuota del contrato agotada.final

Al sondear, detente en cuanto jobStatus alcance un estado final.

stage indica la fase del pipeline. jobStatus: "completed" siempre coincide con stage: "finished" — el momento en que score es definitivo.

stageSignificado
queuedAceptado; a la espera del primer análisis.
analyzingEl análisis de accesibilidad inicial está en curso.
resolvingLa remediación con IA está en curso.
revalidatingEl archivo remediado se está reanalizando; se recalcula score.
finishedTerminado — score refleja el archivo remediado final.
failedEl procesamiento se detuvo por un error.