Para publicar un nuevo mensaje en un servicio, es necesario realizar una petición HTTP POST (con un token válido en el header Authorization) contra la url https://api.vivorecuerdo.es/v1/velatorios/{id}/mensajes, siendo {id} el id de un velatorio, con un JSON con la siguiente estructura:
{
"mensaje": <mensaje en cuestión>*,
"nombre": <nombre de quien deja el mensaje>*,
"parentesco": <parentesco>*
}
Todos los campos son obligatorios.
Es importante tener en cuenta que aunque no hay límite en la longitud del mensaje, por pantalla solo aparecerán 350 caracteres, acompañados por puntos suspensivos "[...]" indicando que el mensaje continúa, en caso de que se supere dicha longitud.
Así se publicaría un nuevo mensaje en un velatorio con id ficticio 121 usando cURL:
curl -X POST https://api.vivorecuerdo.es/v1/velatorios/121/mensajes -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJkZXNhcnJvbGxvIiwiaXNzIjoidml2b3JlY3VlcmRvIiwidHlwZSI6IkFVVEhFTlRJQ0FUSU9OIiwiaWF0IjoxNTY1MjY5MDkwLCJleHAiOjE1NjUyNzI2OTB9.mUwuoy6LJF8hI3v9w4hZPaLLqkFLSTani5tlKr8Q2_4OzcCGC-TSc8zNY7oVRT7bGiOdtr5QI7cPbaQdelhG-A' -H 'Content-Type: application/json' -d '{
"mensaje":"Descansa en paz",
"nombre":"Juan",
"parentesco":"Amigo de la familia"
}'
Si el mensaje se ha publicado correctamente, la API devuelve un código 201 y otro JSON que incluye, además del mensaje publicado, el id de dicho mensaje.
Ejemplo del JSON devuelto:
{
"id_mensaje": 3591
"mensaje": "Descansa en paz",
"nombre": "Juan",
"parentesco": "Amigo de la familia"
}
Si la petición falla, la API devuelve un error 403 en caso de que sea por falta de permisos, un error 400 en caso de que no se hayan introducido bien los datos, o un error 500 en caso de un error en el servidor.