Operações

Histórico de versões

Toda escrita bem-sucedida gera uma nova versão do recurso, e as versões anteriores continuam legíveis. É o caminho para auditar o que mudou, quando, e o que o recurso continha antes de uma integração sobrescrevê-lo.

O endpoint é genérico: funciona para qualquer tipo de recurso.

GET
/fhir/resources/:resource_type/:id/_history/:version_id
1curl https://landing-zone-api.nilo.services/fhir/resources/Patient/ba200cfa-dae0-46cf-81a0-008e3f7414b4/_history/MTc4NjAyMTQ1MjkwNTAwMDM2Nw \
2     -H "x-api-key: <apiKey>"
Try it
Response
1{}

O version_id é o valor de meta.versionId da versão desejada, copiado como veio.

O versionId não é sequencial. É um valor opaco: a codificação em base64 do instante da gravação, em nanossegundos — MTc4NjAyMTQ1MjkwNTAwMDM2Nw decodifica para 1786021452905000367. Não existe versão 1, 2 ou 3, e não dá para chegar à versão anterior somando ou subtraindo. Guarde o meta.versionId de cada resposta se quiser poder voltar a ela.

A versão corrente também é acessível por aqui, mas é mais simples lê-la pelo endpoint normal do recurso.

resource_type é o nome do recurso FHIR com a mesma grafia usada nas demais rotas — Patient, Practitioner, Encounter. Um tipo inexistente responde 404.