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.

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 Fontes e evidência