2xx · Éxito
Código HTTP 202 Accepted: qué significa
El código 202 Accepted significa que el servidor ha recibido la petición y la procesará más tarde, de forma asíncrona. No garantiza que la operación vaya a terminar bien: solo que se ha encolado. Es típico en exportaciones, envíos masivos o conversiones de vídeo.
Qué significa el código 202
Algunas operaciones tardan demasiado para hacer esperar al cliente (generar un informe de 10 000 filas, transcodificar un vídeo). El servidor responde 202 enseguida y procesa la tarea en segundo plano.
Lo correcto es devolver en el cuerpo, o en Location, una URL donde consultar el estado de la tarea, para que el cliente pueda preguntar cada cierto tiempo si ya está lista.
Cuándo aparece
- Tareas encoladas (Celery, RQ, BullMQ, colas de mensajes).
- Webhooks que el receptor acepta y procesa después.
Qué tener en cuenta
- Devuelve un identificador de tarea y un endpoint de estado (/api/tareas/{id}).
- Si el cliente necesita el resultado inmediato, la operación debería ser síncrona y devolver 200 o 201.
Ejemplo de respuesta
HTTP/1.1 202 Accepted
Location: /api/exportaciones/42
Content-Type: application/json
{"tarea": 42, "estado": "en_cola"}Preguntas frecuentes
¿Qué diferencia hay entre 202 y 201?
201 confirma que el recurso ya está creado. 202 solo confirma que la petición se ha recibido y que se procesará después.