GET
https://api.getincloud.online/raven/v3/messages/{id}Información del mensaje SMS
Consulta los datos y el estado de un mensaje SMS de salida enviado 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 recuperar información sobre un mensaje SMS de salida enviado previamente. Debes proporcionar el identificador único (id) del mensaje.
GET https://api.getincloud.online/raven/v3/messages/{id}Parámetros de la ruta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string | Sí | Identificador único del mensaje SMS que deseas consultar. Es el ID devuelto al enviar un mensaje con éxito. |
Parámetros de la consulta
En este endpoint de consulta por ID no se suelen requerir parámetros adicionales en la URL más allá del identificador en la ruta.
Respuestas
200 OK
La solicitud fue exitosa y se devuelve la información del mensaje.
| Campo | Tipo | Descripción |
|---|---|---|
| id | string | Identificador único del mensaje. |
| from | string | Código o número desde el cual se originó el mensaje. |
| to | string | Número de destino en formato E.164. |
| text | string | Contenido del mensaje enviado. |
| status | string | Estado actual del mensaje (ej. Delivered, Sent, Failed, Buffered). |
| segments | integer | Número de segmentos en los que se dividió el mensaje para su entrega. |
| externalId | string | Identificador personalizado proporcionado en la solicitud original, si existe. |
| clientId | string | ID del cliente asociado a la transacción. |
| created_at | string | Fecha y hora de creación del mensaje (formato ISO 8601). |
| updated_at | string | Fecha y hora de la última actualización de estado del mensaje. |
| error_code | string (opcional) | Si el mensaje falló, código de error específico proporcionado por el operador. |
Errores
| Código | Descripción |
|---|---|
| 401 Unauthorized | Error de autenticación. El token no es válido o ha expirado. |
| 404 Not Found | No se encontró ningún mensaje con el id proporcionado. |
| 500 Internal Server Error | Error interno del servidor al recuperar la información. |
Notas técnicas
- Retención de datos: la información del mensaje puede estar sujeta a políticas de retención. Los mensajes muy antiguos podrían no estar disponibles en este endpoint.
- Actualización de estados: el estado devuelto refleja la última actualización recibida del operador de red. En algunos casos puede haber una breve latencia entre la entrega real y la actualización en el sistema.
Ejemplo de solicitud
curl --request GET \
--url https://api.getincloud.online/raven/v3/messages/550e8400-e29b-41d4-a716-446655440000 \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'¿Te sirvió esta página?