Para editar um wake existente, é necessário fazer uma solicitação HTTP PUT (com um token válido no cabeçalho de autorização) contra o URL https://api.vivorecuerdo.es/v1/velatorios/{id}, onde {id} é o id do velório, com um JSON semelhante ao seguinte (o mesmo formato usado para o registro de velório, com exceção do campo "nombre_sala"), embora usando apenas os campos que se destinam a ser editados :
{
"fecha_defuncion": <data de morte (DD/MM/AAAA)>,
"localidad": <lugar da morte>,
"nombre": <nome do falecido>,
"apellidos": <sobrenome do falecido>,
"sobrenombre": <apelido>,
"fecha_nacimiento": <data de nascimento (DD/MM/AAAA)>,
"lugar_nacimiento": <cidade de nascimento>,
"provincia_pais_nacimiento": <província ou país de nascimento>,
"fecha_ceremonia": <data da cerimônia (DD/MM/AAAA)>,
"lugar_ceremonia": <local da cerimônia>,
"poblacion_ceremonia": <população da cerimônia>,
"hora_ceremonia": <hora da cerimônia (hh:mm)>,
"cementerio_crematorio": <cemitério ou crematório>,
"poblacion_cementerio_crematorio": <população de cemitério/crematório>,
"nombre_opcional_cementerio_crematorio": <nome opcional do cemitério/crematório>,
"idioma_velatorio": <acordar a linguagem>,
"tlf_admin_1": <telefone do administrador 1>,
"tlf_admin_2": <telefone do administrador 2>,
"tlf_admin_3: <telefone do administrador 3>,
"tlf_admin_4: <telefone do administrador 4>,
"tlf_admin_5: <telefone do administrador 5>,
}
É importante observar que as datas são inseridas no formato "DD/MM/AAAA" e as horas em "hh:mm" (os minutos sendo múltiplos de cinco, ou seja, "11:00", "11:05", "11:10", etc.). No caso de campos "fecha_ceremonia" e "hora_ceremonia", essas datas/horas devem ser sempre posteriores à data/hora do registro do velório
Quanto ao campo "cementerio_crematorio", neste é indicado "cemitério" se o falecido for enterrado em um cemitério ou "crematório" se for cremado.
Por outro lado, os números de telefone dos administradores podem ser introduzidos com ou sem código do país (+351 XXXXXXXXX ou XXXXXXXXX) no caso dos números espanhóis, no caso dos números internacionais a utilização do código do país é obrigatória. Os números de telefone inseridos durante os testes de integração não são aleatórios, pois o sistema envia automaticamente um SMS para os administradores para que possam utilizar o serviço.
Em relação aos números de telefone dos administradores, é muito importante preenchê-los em ordem. Por exemplo, se houver dois administradores, eles devem ocupar os campos "tlf_admin_1" y "tlf_admin_2", caso contrário, podem ocorrer inconsistências.
Para o campo "idioma_velatorio" você deve escolher entre espanhol ("es_ES"), inglês ("en_GB"), catalão ("ca_ES") ou português ("pt_PT").
Por exemplo, é assim que a data e a hora da cerimônia de vigília seriam modificadas com 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",
}'
Se você quiser limpar um campo que já foi atribuído, use a string reservada "!Clear" para limpá-lo.
Por exemplo, é assim que o campo do apelido de ativação seria limpo com 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"
}'
Se a modificação for bem-sucedida, a API retorna um código 200 e outro JSON que inclui todos os dados de ativação, com as modificações aplicadas:
{
"id" : 121
"fecha_defuncion": "04/12/2017",
"localidad": "Esmoriz",
"nombre": "Rafael",
"apellidos": "Baeza López",
"fecha_nacimiento": "20/07/1939",
"lugar_nacimiento": "Esmoriz",
"provincia_pais_nacimiento": "Portugal",
"fecha_ceremonia": "31/12/2020",
"lugar_ceremonia": "Paróquia Nossa Senhora do Rosário",
"poblacion_ceremonia": "Esmoriz",
"hora_ceremonia": "10:00",
"cementerio_crematorio": "cemitério",
"poblacion_cementerio_crematorio": "Esmoriz",
"nombre_opcional_cementerio_crematorio": "Municipal",
"nombre_sala": "Sala 1",
"idioma_velatorio": "pt_PT",
"tlf_admin_1": "+351 XXXXXXXXX",
"tlf_admin_2": "XXXXXXXXX",
"tlf_admin_3: "XXXXXXXXX",
"url_corta": "vrdo.pt/xxxx",
}
Se a solicitação falhar, a API retorna um erro 403 caso seja por falta de permissões, um erro 400 caso os dados não tenham sido inseridos corretamente pela agência funerária ou um erro 500 caso seja um erro no servidor .