As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Recuperando detalhes do conceito com `$lookup`
<a name="reference-fhir-operations-lookup"></a>

AWS HealthLake agora suporta a `$lookup` operação de CodeSystem recursos, permitindo que você recupere detalhes sobre um conceito específico em um sistema de código fornecendo informações de identificação, como seu código. Essa operação é particularmente útil quando você precisa:
+ Recupere informações detalhadas sobre códigos médicos específicos
+ Valide os significados e propriedades do código
+ Acesse definições e relacionamentos de conceitos
+ Support a tomada de decisões clínicas com dados terminológicos precisos

## Usage
<a name="lookup-usage"></a>

A `$lookup` operação pode ser invocada em CodeSystem recursos usando os métodos GET e POST:

**Operações com Suporte**  


```
GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup
```

## Parâmetros compatíveis
<a name="lookup-parameters"></a>

HealthLake suporta um subconjunto de parâmetros FHIR R4: `$lookup`


| Parâmetro | Tipo | Obrigatório | Description | 
| --- | --- | --- | --- | 
| code | código | Sim | O código conceitual que você está procurando (por exemplo, “71620000" no SNOMED CT) | 
| system | uri | Sim | O URL canônico do sistema de código (por exemplo, "[http://snomed.info/sct](http://snomed.info/sct) “) | 
| version | string | Não | Versão específica do sistema de código | 

## Exemplos
<a name="lookup-examples"></a>

**Solicitação GET**  


```
GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
```

**Solicitação POST**  


```
POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
```

**Resposta da amostra**  
A operação retorna um recurso de Parâmetros contendo os detalhes do conceito:

```
{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}
```

## Parâmetros de resposta
<a name="lookup-response-parameters"></a>

A resposta inclui os seguintes parâmetros, quando disponíveis:


| Parâmetro | Tipo | Description | 
| --- | --- | --- | 
| name | string | Nome do sistema de código | 
| version | string | Versão do sistema de código | 
| display | string | Nome de exibição do conceito | 
| designation | BackboneElement | Representações adicionais para esse conceito. | 
| property | BackboneElement | Propriedades adicionais do conceito (definição, relacionamentos, etc.) | 

## Comportamento
<a name="lookup-behavior"></a>

A `$lookup` operação:

1. Valida os parâmetros necessários (`code`e`system`)

1. Pesquisa o conceito dentro do sistema de código especificado armazenado no armazenamento de dados

1. Retorna informações detalhadas do conceito, incluindo nome de exibição, designações e propriedades.

1. Suporta pesquisas específicas da versão quando o parâmetro é fornecido `version`

1. Opera somente em sistemas de código armazenados explicitamente no armazenamento de HealthLake dados

## Tratamento de erros
<a name="lookup-error-handling"></a>

A operação trata das seguintes condições de erro:
+ 400 Solicitação inválida: `$lookup` operação inválida (solicitação não conforme ou ausência de parâmetros obrigatórios)
+ 404 Não encontrado: sistema de código não encontrado ou código não encontrado no sistema de código especificado

## Advertências
<a name="lookup-caveats"></a>

Para esta versão, não há suporte para o seguinte:
+ `$lookup`operação chamando servidores de terminologia externos
+ `$lookup`operação CodeSystems gerenciada por HealthLake , mas não armazenada explicitamente no armazenamento de dados

Para obter mais informações sobre a especificação da `$lookup` operação, consulte a documentação do [FHIR CodeSystem `$lookup` R4](https://www.hl7.org/fhir/R4/codesystem-operation-lookup.html).