Recursos · 107

Tareas API asíncronas

Una solicitud aceptada no demuestra que el trabajo haya terminado.

Actualizado · 2 min

Lo que esta guía ayuda a lograr

  • Definir estados y derechos
  • Reanudar el seguimiento
  • Confirmar la salida

Comprobación rápida

  • ¿202 demuestra que el trabajo terminará?
  • ¿Cancelar equivale a borrar lo ya producido?

Método paso a paso

  1. 1

    Definir estados y derechos

    Distinga aceptado, pendiente, activo, terminado, fallido y cancelación solicitada. HTTP 202 no garantiza éxito. Autorice por cuenta las consultas, resultados y cancelaciones; el identificador no sustituye los permisos.

    Cuenta, operación e identificador reutilizable

  2. 2

    Reanudar el seguimiento

    Conserve la referencia existente. Defina intervalo, duración, caducidad y qué hacer si falta el estado. Si se admite protección contra duplicados, documente su alcance y pruebe la respuesta perdida antes de repetir la solicitud.

    Estado, hora, intervalo y caducidad

  3. 3

    Confirmar la salida

    Pruebe cancelación mientras se procesa o publica, error del trabajador y resultado caducado. Compruebe los efectos restantes y detenga las consultas al llegar a un estado terminal.

    Resultado, error, cancelación y efectos restantes

Hoja de cálculo reutilizable

Complete con sus observaciones autorizadas. Estos campos son una plantilla de trabajo, no resultados observados.

CampoInformación a registrar
ReferenciaCuenta, operación e identificador reutilizable
SeguimientoEstado, hora, intervalo y caducidad
SalidaResultado, error, cancelación y efectos restantes
AceptaciónUna tarea autorizada y resultado comprobado tras interrupción

Ejemplo trabajado ficticio

Situación ilustrativa

Ejemplo ficticio: se pierde la respuesta de aceptación de un export y la persona vuelve a intentarlo.

Decisión y pruebas esperadas

El ensayo comprueba si el contrato de repetición devuelve la tarea existente. Si no existe esa garantía, debe verificarse la solicitud antes de crear otra; no se deduce unicidad de la interfaz.

Indicadores de gestión

IndicadorQué midePrimera acción
Tareas detenidasSolicitudes sin actualización dentro del plazo definidoAsignar revisión, recuperación o cierre
ReanudaciónSeguimientos retomados sin crear otra tareaInvestigar reinicios y duplicados

Errores comunes

    Preguntas frecuentes

    ¿202 demuestra que el trabajo terminará?

    No. Confirma aceptación para procesamiento, no el resultado final. Consulte el estado de la operación.

    ¿Cancelar equivale a borrar lo ya producido?

    No necesariamente. Confirme el estado final y concilie los efectos que ya existen.

    Referencias oficiales

    Las referencias respaldan el método. Adapte los controles a su contexto; no constituyen certificación. Los títulos de referencia originales y los documentos fuente pueden estar en otro idioma.

    Referencias consultadas el .