PATCH
https://api.getincloud.online/jacaerys/v1/forwards/{id}/resumeReanudar proceso de reenvío
Reactiva un proceso de reenvío que fue pausado previamente.
API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
Este endpoint permite reactivar un proceso de reenvío que fue pausado previamente. Una vez reanudado, el sistema vuelve a procesar los mensajes entrantes (MO) que coincidan con los criterios de origen y palabra clave, enviándolos a la targetUrl configurada.
PATCH https://api.getincloud.online/jacaerys/v1/forwards/{id}/resumeParámetros de la ruta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string | Sí | Identificador único del proceso de reenvío que se desea reanudar. |
Parámetros del cuerpo
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| externalId | string | No | Identificador único de tu sistema para rastrear esta solicitud de cambio de estado. |
| clientId | string | No | Identificador único del cliente asociado con la solicitud. |
| string | No | Dirección de correo asociada para notificación o auditoría del cambio de estado. | |
| callbackUrl | string | No | URL para recibir una notificación cuando el estado del proceso se actualice a activo. |
Respuestas
| Código | Descripción |
|---|---|
| 200 OK | La reanudación se procesó con éxito. Devuelve id (string, ID del proceso), status (string, nuevo estado, ej. ACTIVE) y updated_at (string, fecha y hora de la actualización en formato ISO 8601). |
| 400 Bad Request | Solicitud inválida. El id tiene un formato incorrecto o el cuerpo contiene errores de sintaxis. |
| 401 Unauthorized | El token Bearer es inválido, ha expirado o no se incluyó. |
| 403 Forbidden | El usuario no tiene permisos suficientes para modificar el estado de este proceso. |
| 404 Not Found | No se encontró ningún proceso con el id proporcionado. |
| 409 Conflict | El proceso no puede reanudarse porque ya está en un estado que impide la acción (ej. ya está activo o fue eliminado). |
| 500 Internal Server Error | Error inesperado en el servidor al intentar reanudar el proceso. |
Notas técnicas
- Procesamiento de mensajes: la reanudación solo afecta a los mensajes que lleguen después de que el estado cambie a ACTIVE. Los mensajes que llegaron mientras el proceso estaba en PAUSED no se procesan ni se reenvían retroactivamente.
- Trazabilidad: este cambio de estado se refleja inmediatamente en los logs del sistema. Se recomienda usar externalId para mantener la trazabilidad con tus sistemas internos.
Ejemplos
Solicitud
curl --request PATCH \
--url https://api.getincloud.online/jacaerys/v1/forwards/550e8400-e29b-41d4-a716-446655440000/resume \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--data '
{
"externalId": "resume-req-002",
"clientId": "client_abc_123",
"email": "admin@empresa.com"
}
'Respuesta 200 OK
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "ACTIVE",
"updated_at": "2023-11-18T11:30:00Z"
}Respuesta 409 Conflict
{
"error": "Conflict",
"message": "The forward process is already in ACTIVE status."
}AnteriorPausar procesos de reenvío del propietarioSiguienteReanudar un proceso de reenvío: ejemplo y respuestas
¿Te sirvió esta página?