Busca e registros de medicamentos

Busca por nome e filtros#

GET /v1/medications/search procura uma substring literal do nome oficial, sem distinção entre maiúsculas e minúsculas. Não é o Resolve: a busca retorna uma lista de registros, sem declarar que uma consulta identifica uma variante única. %, _ e ! não são curingas.

curl --fail-with-body --get "$IABULA_API_BASE/v1/medications/search" \
  --header "X-API-Key: $IABULA_API_KEY" \
  --data-urlencode 'q=dipirona' \
  --data-urlencode 'limit=20'

q aceita de 1 a 256 caracteres quando informado. limit aceita de 1 a 100, com padrão 20. ingredient_id e category_id são UUIDs canônicos. dosage_form é igualdade com a forma canônica, sem distinção de caixa. Filtros dependem de vínculos realmente existentes no catálogo.

Paginação estável por cursor#

Cada página contém data e next_cursor. Passe o cursor recebido sem decodificar ou alterá-lo. O cursor de busca está associado aos filtros; para mudar q ou outro filtro, recomece sem cursor. Cursor inválido ou usado com filtros diferentes resulta em HTTP 400.

curl --fail-with-body --get "$IABULA_API_BASE/v1/medications/search" \
  --header "X-API-Key: $IABULA_API_KEY" \
  --data-urlencode "q=dipirona" \
  --data-urlencode "cursor=$IABULA_CURSOR"

Identificação exata#

GET /v1/medications/lookup aceita scheme EAN, CMED_GGREM ou CMED_REGISTRO e value literal. matched identifica um candidato; ambiguous preserva candidatos separados; unresolved não cria correspondência por nome. Cada candidato traz IDs reutilizáveis e evidência da fonte.

curl --fail-with-body --get "$IABULA_API_BASE/v1/medications/lookup"   --header "X-API-Key: $IABULA_API_KEY"   --data-urlencode "scheme=EAN"   --data-urlencode "value=7891058021580"

Detalhe pelo UUID retornado#

Use um id retornado pela busca em GET /v1/medications/{id}. O detalhe inclui product_id e listas de apresentações, registros, empresas e categorias quando disponíveis. Não invente UUIDs nem deduza um UUID a partir de um nome. Um ID inexistente retorna HTTP 404.

curl --fail-with-body "$IABULA_API_BASE/v1/medications/$IABULA_MEDICATION_ID" \
  --header "X-API-Key: $IABULA_API_KEY"

Interprete os campos com evidência#

product_name, brand_name, dosage_form e active_ingredient_text têm semânticas distintas. Campos sem mapeamento podem ser nulos. active_ingredient_text conserva texto da fonte e não prova um vínculo a ActiveIngredient. Categorias regulatórias não são indicações clínicas.

GET /v1/medications/search#

GET /v1/medications/lookup#

GET /v1/medications/{id}#

Campos do contrato OpenAPI#