Para la edición de un velatorio existente, es necesario realizar una petición HTTP PUT (con un token válido en el header Authorization) contra la URL https://api.vivorecuerdo.es/v1/velatorios/{id}, siendo {id} el id del velatorio, con un JSON similar al siguiente (el mismo formato utilizado para el registro de velatorios, a excepción del campo "nombre_sala"), aunque utilizando sólo los campos que se pretenden editar:
{
"fecha_defuncion": <fecha de defunción (DD/MM/AAAA)>,
"localidad": <localidad de defunción>,
"nombre": <nombre del fallecido>,
"apellidos": <apellidos del fallecido>,
"sobrenombre": <sobrenombre>,
"fecha_nacimiento": <fecha de nacimiento (DD/MM/AAAA)>,
"lugar_nacimiento": <localidad de nacimiento>,
"provincia_pais_nacimiento": <provincia o país de nacimiento>,
"fecha_ceremonia": <fecha de la ceremonia (DD/MM/AAAA)>,
"lugar_ceremonia": <lugar de la ceremonia>,
"poblacion_ceremonia": <población de la ceremonia>,
"hora_ceremonia": <hora de la ceremonia (hh:mm)>,
"texto_adicional": <texto adicional>,
"cementerio_crematorio": <cementerio o crematorio (cementerio/crematorio)>,
"poblacion_cementerio_crematorio": <población del cementerio/crematorio>,
"nombre_opcional_cementerio_crematorio": <nombre opcional del cementerio/crematorio>,
"fecha_cementerio_crematorio": <fecha del entierro/cremación (DD/MM/AAAA)>,
"hora_cementerio_crematorio": <hora del entierro/cremación (hh:mm)>,
"fecha_fin_servicio": <fecha de fin de servicio (DD/MM/AAAA)>,
"hora_fin_servicio": <hora de fin de servicio (hh:mm)>,
"dni_rut": <DNI o RUT>,
"idioma_velatorio": <idioma del velatorio>,
"tlf_admin_1": <teléfono del administrador 1>,
"tlf_admin_2": <teléfono del administrador 2>,
"tlf_admin_3: <teléfono del administrador 3>,
"tlf_admin_4: <teléfono del administrador 4>,
"tlf_admin_5: <teléfono del administrador 5>,
}Es importante tener en cuenta que las fechas se introducen en formato "DD/MM/AAAA" y las horas en "hh:mm" (siendo los minutos múltiplos de cinco, es decir, "11:00", "11:05", "11:10", etc.).
En cuanto al campo "cementerio_crematorio", en este se indica "cementerio" si el fallecido va a ser enterrado en un cementerio o "crematorio" si va a ser incinerado.
Por otro lado, los números de teléfono de los administradores pueden introducirse con o sin código de país (+34 XXXXXXXXX ó XXXXXXXXX) en el caso de números españoles, en el caso de números internacionales es obligatorio el uso del código de país.
Respecto a los teléfonos de administradores, es muy importante rellenarlos por orden. Por ejemplo, si sólo existe un administrador y se quiere añadir un segundo, este ha de ocupar el campo "tlf_admin_2", de lo contrario se pueden producir inconsistencias.
Para el campo "idioma_velatorio" hay que elegir entre castellano ("es_ES"), inglés ("en_GB"), catalán ("ca_ES") o portugués ("pt_PT").
Por ejemplo, así se modificarían la fecha y la hora de la ceremonia del velatorio con id 121 usando cURL:
curl -X PUT https://api.vivorecuerdo.es/v1/velatorios/121 -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJkZXNhcnJvbGxvIiwiaXNzIjoidml2b3JlY3VlcmRvIiwidHlwZSI6IkFVVEhFTlRJQ0FUSU9OIiwiaWF0IjoxNTY1MjY5MDkwLCJleHAiOjE1NjUyNzI2OTB9.mUwuoy6LJF8hI3v9w4hZPaLLqkFLSTani5tlKr8Q2_4OzcCGC-TSc8zNY7oVRT7bGiOdtr5QI7cPbaQdelhG-A' -H 'Content-Type: application/json' -d '{
"fecha_ceremonia": "31/12/2020",
"hora_ceremonia": "10:00",
}'
En caso de querer limpiar un campo que ya estaba asignado hay que utilizar la cadena reservada "!clear" para borrarlo.
Por ejemplo, así se limpiaría el campo sobrenombre del velatorio con id 121 usando cURL:
curl -X PUT https://api.vivorecuerdo.es/v1/velatorios/121 -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJkZXNhcnJvbGxvIiwiaXNzIjoidml2b3JlY3VlcmRvIiwidHlwZSI6IkFVVEhFTlRJQ0FUSU9OIiwiaWF0IjoxNTY1MjY5MDkwLCJleHAiOjE1NjUyNzI2OTB9.mUwuoy6LJF8hI3v9w4hZPaLLqkFLSTani5tlKr8Q2_4OzcCGC-TSc8zNY7oVRT7bGiOdtr5QI7cPbaQdelhG-A' -H 'Content-Type: application/json' -d '{
"sobrenombre": "!clear"
}'
Si la modificación es exitosa, la API devuelve un código 200 y otro JSON que incluye todos los datos del velatorio, con las modificaciones aplicadas:
{
"id" : 121
"fecha_defuncion": "04/12/2017",
"localidad": "Torre Pacheco",
"nombre": "Rafael",
"apellidos": "Baeza López",
"fecha_nacimiento": "20/07/1939",
"lugar_nacimiento": "Lora del Río",
"provincia_pais_nacimiento": "Sevilla",
"fecha_ceremonia": "31/12/2020",
"lugar_ceremonia": "Parroquia Ntra. Sra. del Rosario",
"poblacion_ceremonia": "Torre Pacheco",
"hora_ceremonia": "10:00",
"cementerio_crematorio": "cementerio",
"poblacion_cementerio_crematorio": "Torre Pacheco",
"nombre_opcional_cementerio_crematorio": "Municipal",
"fecha_cementerio_crematorio": "31/12/2020",
"hora_cementerio_crematorio": "12:00",
"fecha_fin_servicio": "31/12/2020",
"hora_fin_servicio": "18:00",
"nombre_sala": "Sala 1",
"idioma_velatorio": "es_ES",
"tlf_admin_1": "+34 XXXXXXXXX",
"tlf_admin_2": "XXXXXXXXX",
"tlf_admin_3: "XXXXXXXXX",
"url_corta": "vrdo.es/xxxx",
}
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 por parte del tanatorio, o un error 500 en caso de un error en el servidor.