# Como consultar princípio ativo e DCB na API

Distinga texto de princípio ativo de ingrediente canônico e consulte registros DCB usando identificadores aprovados da IaBula.

Canonical: https://iabula.com/docs/guides/obter-principio-ativo

## Comece pelo significado do dado

Um cadastro pode conter o princípio ativo como texto da fonte. Esse texto aparece em active_ingredient_text de MedicationSummary quando disponível. Ele não é um identificador, uma estrutura química nem uma promessa de que há um ActiveIngredient vinculado.

## Use um UUID canônico aprovado

Se sua integração possui um UUID de ActiveIngredient proveniente de vínculo aprovado, consulte GET /v1/ingredients/{id}. O retorno possui name, dcbs e evidence. Não reutilize o id do medicamento como id de ingrediente. Não há busca por nome de ingrediente no V1.

```bash
curl --fail-with-body "$IABULA_API_BASE/v1/ingredients/$IABULA_INGREDIENT_ID" \
  --header "X-API-Key: $IABULA_API_KEY"
```

## Não transforme falta de vínculo em afirmação

Sem UUID canônico, mantenha o texto como texto e sinalize a ausência de vínculo estruturado. Um 404 descreve ausência no catálogo consultado. DCBs fornecem denominações; não autorizam deduções clínicas, equivalência ou substituição de medicamentos.

- [Ingredientes e schema DCB](https://iabula.com/docs/ingredients)
- [Fontes e evidência](https://iabula.com/docs/provenance)

## Recursos

- [OpenAPI JSON](https://iabula.com/openapi.json)
- [Swagger](https://iabula.com/docs/swagger)
- [Documentation index](https://iabula.com/llms.txt)