Skip to main content

Get Message

Endpoint que entrega información de una notificación recibida en un dispositivo, es necesario ingresar tanto el trust_id del dispositivo como el identificador del mensaje (campo llamado message_id).

Los campos action, action_button y error_message son campos que son enviados por el dispositivo y el status que puede tener 3 estados:

  • PENDING = 1. Indica que el mensaje está en cola aún y no ha sido recibido por el móvil.
  • SUCCESS = 2. El mensaje fue recibido exitosamente por el móvil.
  • FAIL = 3. Algo ha salido mal y el mensaje no fue recibido con éxito.

Endpoint#

Headers

KeyValueDescription
Content-Typeapplication/json
AuthorizationBearer {{access_token}}access_token obtained in Atenea

Url

Method: POST
URL: https://api.trust.lat/notifications/device/notification
caution

Recuerda que para utilizar este endpoint es necesario un access token obtenido en el servicio Atenea

Como obtener un access token

Body#

{
"trust_id": "za0c25-5049-44d6-ad75-974c3807e77f",
"message_id": "0:1557245892804251%ffe5a0ffee450"
}

Code Examples#

curl --location --request POST 'https://api.trust.lat/notifications/device/notification' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{accessToken}}' \
--data-raw '{
"trust_id": "za0c25-5049-44d6-ad75-974c3807e77f",
"message_id": "0:1557245892804251%ffe5a0ffee450"
}'

Responses#

HTTP Code: 200 OK#

{
"status": "success",
"code": 200,
"message": "Ok",
"resource": "Notification",
"total": 1,
"data": {
"id": 999999,
"uuid": "ada0386-9bce-4c0b-8ffd-7c7b0e45c0c2",
"device_id": 99999,
"trust_id": "64a5dm8a-2d5c-448e-bb11-7eb88bd425",
"message_id": "0:162368298822216%fee45a9fd7ecd",
"action": "success",
"error_message": "",
"type": "sign_document",
"application_id": 1,
"status": 2,
"action_button": null,
"createdAt": "2021-06-14T15:03:01.859Z",
"updatedAt": "2021-06-14T15:03:07.148Z"
}
}

HTTP Code: 200 OK - No Data#

{
"status": "success",
"code": 200,
"message": "Ok",
"resource": "Notification",
"total": 0,
"data": {}
}

HTTP Code: 422 Unprocessable Entity#

{
"status": "error",
"code": 422,
"message": "Unprocessable Entity",
"resource": "Device",
"total": 0,
"error": [
{
"location": "body",
"param": "trust_id",
"msg": "trust_id is required",
"value": ""
}
]
}
Last updated on by Claudio-Franco