Orientações ao desenvolvedor

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:

  Informe aos desenvolvedores sobre QR Code

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.

  1. 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: https://validar.iti.gov.br/ 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

  2. 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"
           }
         ]
       }
      }


  3. 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.