Consultar

Endpoint	GET /fhir/resources/Encounter
Autenticação	🔓 Chave de API
Status	Implementado

Modelagem da API - Request

---

Headers

Opção	Tipo	Requerido	Descrição				Exemplo
x-api-key	string	Sim	Chave de autenticação do cliente, fornecida durante a configuração do ambiente.
Content-Type	string	Sim					application/json

Parâmetros de caminho

Opção	Tipo	Requerido	Descrição			Exemplo
ID	string	Não	UUID do recurso FHIR.			ba200cfa-dae0-46cf-81a0-008e3f7414b4

Parâmetros de Query

Você poderá utilizar todos os parâmetros de pesquisa disponíveis do recurso canônico.

https://hl7.org/fhir/R4/encounter.html#search

Parâmetros de busca suportados

Nome	Tipo	Descrição	Expressão FHIR
identifier	token	Identificador externo da consulta	Encounter.identifier
patient	reference	Paciente associado à consulta	Encounter.subject
status	token	Status da consulta (planned | arrived | triaged | in-progress | onleave | finished | cancelled)	Encounter.status
date	date	Data de início da consulta	Encounter.period
_lastUpdated	date	Data da última atualização do registro	Encounter.meta.lastUpdated

Exemplos de Requisições

Buscar por identificador

Buscar Encounter por identificador do sistema integrado

curl --request GET \
--url https://landing-zone-api.nilo.services/fhir/resources/Encounter?identifier=https://www.acmesaude.com.br/integracao/consulta|12345 \
--header 'Content-Type: application/json' \
--header 'x-api-key: <inserir API Key aqui>'

Buscar por identificador do paciente

Buscar Encounter por identificador do paciente no sistema integrado

curl --request GET \
--url https://landing-zone-api.nilo.services/fhir/resources/Encounter?patient.identifier=https://www.acmesaude.com.br/integracao/paciente|440623 \
--header 'Content-Type: application/json' \
--header 'x-api-key: <inserir API Key aqui>'

Buscar por status

Buscar Encounter por status (ex: finished, in-progress)

curl --request GET \
--url https://landing-zone-api.nilo.services/fhir/resources/Encounter?status=finished \
--header 'Content-Type: application/json' \
--header 'x-api-key: <inserir API Key aqui>'

Modelagem da API - Response

---

✔ 200

Operação bem sucedida.

	Array of objects Uma lista de recursos do pacote.
	Array of objects Um conjunto de links que fornecem contexto/navegação neste pacote.
resourceType required	string Default: "Bundle" Indica o tipo do recurso transacionado.
type required	string Enum: "document" "message" "transaction" "transaction-response" "batch" "batch-response" "history" "searchset" "collection" Indica a finalidade deste pacote, como ele deve ser usado.

{

• "entry": [

  • {

    • "fullUrl": "{host}/fhir/resources/.../7d154473-...-a5ce077ef77f",
    • "request": {

      • "method": "POST",
      • "url": "Patient"

      },
    • "resource": {

      • "id": "903dAAe9-c57f-4eb3-bd1c-65XXd41exx81",
      • "meta": {

        • "lastUpdated": "2022-05-25T18:42:06.551129+00:00",
        • "versionId": "903dAAe9-c57f-4eb3-bd1c-65XXd41exx81"

        },
      • "resourceType": "Encounter",
      • "class": {

        • "code": "VR",
        • "display": "virtual",
        • "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode"

        },
      • "identifier": [

        • {

          • "system": "{host}/fhir/resources/NamingSystem/hippocrates-api--model-name",
          • "use": "usual",
          • "value": "12345"

          }

        ],
      • "length": {

        • "id": "string",
        • "value": 0

        },
      • "participant": [

        • {

          • "individual": {

            • "identifier": {

              • "system": "{host}/fhir/resources/NamingSystem/...unit",
              • "use": "usual",
              • "value": "12345"

              },
            • "type": "Practitioner"

            },
          • "type": [

            • {

              • "coding": [

                • {

                  • "code": "ATND",
                  • "display": "attender",
                  • "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType"

                  }

                ],
              • "text": "attender"

              }

            ]

          }

        ],
      • "period": {

        • "end": "2022-05-23T19:00:00+00:00",
        • "start": "2022-05-23T19:00:00+00:00"

        },
      • "status": "finished",
      • "subject": {

        • "identifier": {

          • "system": "{host}/fhir/resources/NamingSystem/...unit",
          • "use": "usual",
          • "value": "12345"

          },
        • "type": "Patient"

        }

      },
    • "search": {

      • "mode": "match"

      }

    }

  ],
• "link": [

  • {

    • "relation": "next",
    • "url": "{host}/fhir/resources/Patient?_page_token=Cjj3YopYuf%2F%2F%2F%2F%2BABd%2BbgE0m...dSANQAFoLCUSM7w9VYUqaEANglLWUugQ%3D"

    }

  ],
• "resourceType": "Bundle",
• "type": "searchset"

}

✘ 400

Parâmetro enviado inválido.

required	Array of objects Uma coleção de mensagens de erro, aviso ou informação que resultado de uma ação do sistema.
resourceType required	string Default: "OperationOutcome" Indica o tipo do recurso transacionado.

{

• "issue": [

  • {

    • "code": "exception",
    • "details": {

      • "text": "Parâmetro enviado inválido"

      },
    • "severity": "error"

    }

  ],
• "resourceType": "OperationOutcome"

}

✘ 500

Erro inesperado.