Além das novas funcionalidades, o ITI divulga hoje seu primeiro informe direcionado exclusivamente aos desenvolvedores. Tratam-se de informações relevantes para esses profissionais.
Neste primeiro informe, constam orientações sobre QR Code. Confira abaixo:
O Validador de Documentos Digitais lê o QR Code através das câmeras (frontal ou traseira) do celular ou da webcam de um computador. Para isso, foi desenvolvido um plugin para o portal que lê e envia o arquivo para a validação.
Parâmetros:
Os seguintes parâmetros (query parameters) serão adicionados na URL encontrada no QR Code da prescrição:
Nome | Conteúdo | Descrição | Obrigatório |
_format | application/validador-iti+json | Reservado para o uso do Portal Validar do ITI: | Sim |
_secretCode | Conjunto de caracteres alfanuméricos. Variável de 0 a 64 caracteres. | Código informado pelo paciente para permitir o acesso a prescrição. | Sim |
Fluxo operacional esperado:
URL esperada no QR Code:
https://[URL]
Validador monta requisição acrescida do código por exemplo: XIU8789Y
GET https://[URL]/?_format=application/validador-iti+json&_secretCode= XIU8789Y
>Obs: caso a URL possua outros parâmetros será necessário o parâmetro “type” para identificarmos e acrescentarmos. Nesse caso:
GET https://[URL]/?type=prescricao&_parametroqualquer&_format=application/validador-iti+json&_secretCode= XIU8789Y
A resposta será um JSON, contendo a URL para o arquivo PDF assinado.
Resultado esperado conforme resultado a seguir:
{
"version":"1.0.0",
"prescription":{
"signatureFiles":[
{
"url":"url/nomedoarquivo.pdf"
}
]
}
}
Erros:
Códigos de status HTTP retornados:
Código | Nome | Descrição |
401 | Not Authorized | Quando o código secreto está incorreto. |
404 | Not Found | Quando a prescrição não existe. |