Para registrar um novo velório é necessário fazer uma solicitação HTTP POST (com um token válido no cabeçalho de autorização) contra a URL https://api.vivorecuerdo.es/v1/velatorios con un JSON con el siguiente formato:
{
"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>,
"nombre_sala": <nome da sala)>*,
"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>,
}
Os campos marcados com * são obrigatórios.
É 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.
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 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.
Por exemplo, com cURL:
curl -X POST https://api.vivorecuerdo.es/v1/velatorios -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJkZXNhcnJvbGxvIiwiaXNzIjoidml2b3JlY3VlcmRvIiwidHlwZSI6IkFVVEhFTlRJQ0FUSU9OIiwiaWF0IjoxNTY1MjY5MDkwLCJleHAiOjE1NjUyNzI2OTB9.mUwuoy6LJF8hI3v9w4hZPaLLqkFLSTani5tlKr8Q2_4OzcCGC-TSc8zNY7oVRT7bGiOdtr5QI7cPbaQdelhG-A' -H 'Content-Type: application/json' -d '{
"fecha_defuncion": "04/12/2017",
"localidad": "Torre Pacheco",
"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": "11: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",
}'
Se o registro for bem-sucedido, a API retorna um código 201 e outro JSON que inclui, além dos dados cadastrados, o "id" e o "short_url" gerado para aquele wake. É importante guardar esse id, pois é o que permitirá modificações no wake. Em caso de perdê-lo, você sempre pode fazer uma consulta dos velórios ativos para recuperarlo.
Exemplo do JSON retornado:
{
"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": "11: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 .