FHIR (Beta)

Saiba mais sobre o conector FHIR e como usá-lo na Digibee Integration Platform.

O conector FHIR está atualmente em fase beta. Entenda mais sobre o Programa Beta.

O FHIR é integrado ao HAPI-FHIR, uma biblioteca de código aberto que implementa a especificação FHIR (Fast Healthcare Interoperability Resources). Seu principal objetivo é permitir a comunicação fluida entre sistemas de saúde, viabilizando a troca, recuperação e gestão de dados compatíveis com o FHIR.

Parâmetros

Dê uma olhada nos parâmetros de configuração do conector. Parâmetros suportados por expressões Double Braces estão marcados com (DB).

Aba General

Parâmetro

Descrição

Valor padrão

Tipo de dado

Account

A conta usada pelo conector. Tipo suportado: Basic.

N/A

Account

Fail On Error

Se a opção for ativada, a execução do pipeline com erro será interrompida. Caso contrário, a execução do pipeline continua, mas o resultado mostrará um valor falso para a propriedade "success".

False

Booleano

Aba Host

Parâmetro

Descrição

Valor padrão

Tipo de dado

Host (DB)

A URL base do servidor FHIR.

N/A

String

Path

O recurso ou endpoint específico do FHIR a ser acessado. Com base no caminho selecionado, opções adicionais podem estar disponíveis para configurar parâmetros de consulta ou outras configurações necessárias. Para detalhes sobre cada endpoint, consulte a documentação do HAPI FHIR.

N/A

String

Method

O método HTTP usado para a solicitação.

N/A

String

Aba Settings

Parâmetro

Descrição

Valor padrão

Tipo de dado

Connect Timeout (ms)

Tempo máximo permitido para estabelecer uma conexão, em milissegundos.

30000

Integer

Read Timeout (ms)

Tempo máximo permitido para ler dados, em milissegundos.

30000

Integer

Stop on Client Error

Quando ativado, interrompe a execução do pipeline se ocorrer um erro HTTP 4xx.

False

Booleano

Stop on Server Error

Quando ativado, interrompe a execução do pipeline se ocorrer um erro HTTP 5xx.

False

Booleano

Override Response Charset

Quando ativado, substitui o charset retornado pelo endpoint especificado na propriedade Response Charset. Caso contrário, o charset do cabeçalho Content-Type é usado.

True

Booleano

Response Charset

Define o charset a ser utilizado quando Override Response Charset estiver ativado. Padrão: UTF-8.

UTF-8

String

Advanced Settings

Ativa opções de configuração adicionais.

False

Booleano

Raw Mode

Quando ativado, permite o envio ou recebimento de um payload não-JSON.

False

Booleano

Save as Local File

Quando ativado, salva a resposta como um arquivo no diretório local do pipeline.

False

Booleano

Allow Insecure Endpoints

Quando ativado, permite chamadas para endpoints HTTPS sem aplicar verificações de segurança.

False

Booleano

Enable Retries

Quando ativado, tenta repetir as solicitações em caso de erros do servidor.

False

Booleano

Compress Body with GZIP

Quando ativado, compacta o corpo da solicitação usando GZIP.

False

Booleano

Force HTTP 1.1

Quando ativado, força a solicitação a usar HTTP 1.1.

False

Booleano

Disable Connection Pooling

Quando ativado, impede que as conexões sejam reutilizadas. Recomendado para endpoints com problemas de reutilização de conexões.

False

Booleano

Invalidate SSL Sessions on Every Call

Quando ativado, invalida as sessões SSL para cada solicitação. Recomendado para endpoints com problemas de reutilização de sessões SSL. Esta configuração torna o conector de thread único, o que significa que todas as execuções serão executadas sequencialmente para o mesmo conector REST no pipeline.

False

Booleano

Aba Documentation

Parâmetro

Descrição

Valor padrão

Tipo de dado

Documentation

Seção para documentar qualquer informação necessária sobre a configuração do conector e regras de negócio.

N/A

String

Exemplos de uso do FHIR

Recuperar paciente por ID

Configuração do conector

Host: https://hapi.fhir.org/baseR4/
Path: /Patient/{id}
Method: GET
Query {id}: 596573

Saída

{
  "status": 200,
  "statusMessage": "OK",
  "body": {
    "resourceType": "Patient",
    "id": "596573",
    "meta": {
      "versionId": "1",
      "lastUpdated": "2020-02-02T05:20:18.739+00:00",
      "source": "#0ozhPzMD54KooHNz"
    },
    "text": {
      "status": "generated",
      "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\">Atomic <b>DOG </b></div><table class=\"hapiPropertyTable\"><tbody><tr><td>Address</td><td><span>yesLine </span><br/><span>NoDogCatchers </span><span>Land </span><span>Dogville </span></td></tr><tr><td>Date of birth</td><td><span>07 March 3000</span></td></tr></tbody></table></div>"
    },
    "name": [
      {
        "family": "Dog",
        "given": [
          "Atomic"
        ]
      }
    ],
    "telecom": [
      {
        "system": "phone",
        "value": "5555555555",
        "use": "mobile"
      }
    ],
    "gender": "male",
    "birthDate": "3000-03-07T22:00:00.00Z",
    "address": [
      {
        "use": "home",
        "line": [
          "yesLine"
        ],
        "city": "NoDogCatchers",
        "state": "Land",
        "postalCode": "12345",
        "country": "Dogville"
      }
    ]
  },
  "headers": {
    "Connection": "keep-alive",
    "Content-Location": "https://hapi.fhir.org/baseR4/Patient/596573/_history/1",
    "Content-Type": "application/fhir+json;charset=utf-8",
    "Date": "Fri, 21 Feb 2025 12:50:44 GMT",
    "ETag": "W/\"1\"",
    "Last-Modified": "Sun, 02 Feb 2020 05:20:18 GMT",
    "Server": "nginx/1.24.0 (Ubuntu)",
    "Transfer-Encoding": "chunked",
    "X-Powered-By": "HAPI FHIR 7.7.15-SNAPSHOT/3594770bf6/2024-12-21 REST Server (FHIR Server; FHIR 4.0.1/R4)",
    "X-Request-ID": "kVmj43rHoE0xtUfb"
  }
}

Pesquisar paciente por nome

Configuração do conector

Host: https://hapi.fhir.org/baseR4/
Path: /Patient
Method: GET
Query {name}: Smith

Saída

{
  "status": 200,
  "statusMessage": "OK",
  "body": {
    "resourceType": "Bundle",
    "id": "756a0990-9d0f-4e8b-b39b-0dddd683471f",
    "meta": {
      "lastUpdated": "2025-02-21T13:29:38.190+00:00"
    },
    "type": "searchset",
    "link": [
      {
        "relation": "self",
        "url": "https://hapi.fhir.org/baseR4/Patient?name=Smith"
      },
      {
        "relation": "next",
        "url": "https://hapi.fhir.org/baseR4?_getpages=756a0990-9d0f-4e8b-b39b-0dddd683471f&_getpagesoffset=20&_count=20&_pretty=true&_bundletype=searchset"
      }
    ],
    "entry": [
      {
        "fullUrl": "https://hapi.fhir.org/baseR4/Patient/pat2",
        "resource": {
          "resourceType": "Patient",
          "id": "pat2",
          "meta": {
            "versionId": "6",
            "lastUpdated": "2025-02-03T10:47:21.221+00:00",
            "source": "#n1HxCzy7fO78KKI0",
            "security": [
              {
                "system": "http://essai.abcfg.com/",
                "code": "code1",
                "display": "coded1"
              }
            ],
            "tag": [
              {
                "system": "http://essai.abcfg.com/",
                "code": "tag1",
                "display": "tagd1"
              }
            ]
          },
          "text": {
            "status": "generated",
            "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\">John <b>SMITH </b></div><table class=\"hapiPropertyTable\"><tbody><tr><td>Date of birth</td><td><span>15 March 1985</span></td></tr></tbody></table></div>"
          },
          "name": [
            {
              "use": "official",
              "family": "Smith",
              "given": [
                "John"
              ]
            }
          ],
          "gender": "male",
          "birthDate": "1985-03-15"
        },
        "search": {
          "mode": "match"
        }
      }
]
  },
  "headers": {
    "Connection": "keep-alive",
    "Content-Type": "application/fhir+json;charset=utf-8",
    "Date": "Fri, 21 Feb 2025 13:29:38 GMT",
    "Last-Modified": "Fri, 21 Feb 2025 13:29:38 GMT",
    "Server": "nginx/1.24.0 (Ubuntu)",
    "Transfer-Encoding": "chunked",
    "X-Powered-By": "HAPI FHIR 7.7.15-SNAPSHOT/3594770bf6/2024-12-21 REST Server (FHIR Server; FHIR 4.0.1/R4)",
    "X-Request-ID": "DysuUQsEQw3PuYNs"
  }
}

Criar um novo paciente

Configuração do conector

Host: https://hapi.fhir.org/baseR4/
Path: /Patient
Method: POST
Full Body: True
Body:

{
  "resourceType": "Patient",
  "name": [
    {
      "family": "Doe",
      "given": ["Jane"]
    }
  ],
  "gender": "female",
  "birthDate": "1992-04-15"
}

Saída

{
  "status": 201,
  "statusMessage": "Created",
  "body": {
    "resourceType": "Patient",
    "id": "46273031",
    "meta": {
      "versionId": "1",
      "lastUpdated": "2025-02-21T13:33:27.853+00:00",
      "source": "#2wPqcc0VrXJIvR2o"
    },
    "text": {
      "status": "generated",
      "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div class=\"hapiHeaderText\">Jane <b>DOE </b></div><table class=\"hapiPropertyTable\"><tbody><tr><td>Date of birth</td><td><span>15 April 1992</span></td></tr></tbody></table></div>"
    },
    "name": [
      {
        "family": "Doe",
        "given": [
          "Jane"
        ]
      }
    ],
    "gender": "female",
    "birthDate": "1992-04-15"
  },
  "headers": {
    "Connection": "keep-alive",
    "Content-Location": "https://hapi.fhir.org/baseR4/Patient/46273031/_history/1",
    "Content-Type": "application/fhir+json;charset=utf-8",
    "Date": "Fri, 21 Feb 2025 13:33:27 GMT",
    "ETag": "W/\"1\"",
    "Last-Modified": "Fri, 21 Feb 2025 13:33:27 GMT",
    "Location": "https://hapi.fhir.org/baseR4/Patient/46273031/_history/1",
    "Server": "nginx/1.24.0 (Ubuntu)",
    "Transfer-Encoding": "chunked",
    "X-Powered-By": "HAPI FHIR 7.7.15-SNAPSHOT/3594770bf6/2024-12-21 REST Server (FHIR Server; FHIR 4.0.1/R4)",
    "X-Request-ID": "2wPqcc0VrXJIvR2o"
  }
}

AnteriorIndustry solutions PróximoGupy Public API

Atualizado há 8 dias

Isto foi útil?