Documentação / Referência da API

Sugerir nomes de medicamentos

GET/v1/drugs/suggestions

Retorna nomes distintos de todas as fontes para sugestões durante a digitação. Os nomes exatos vêm primeiro, depois os nomes que começam com o termo buscado e, em seguida, as demais correspondências, com os nomes mais curtos primeiro. Aplique debounce às requisições e ignore respostas desatualizadas quando o termo buscado mudar.

Parâmetros

country string Obrigatório
Código de país ISO 3166-1 de duas letras, em minúsculas. Cada busca é restrita a um único país.
q string Obrigatório
O que o usuário digitou até agora, com pelo menos 3 caracteres.
limit integer
Número de sugestões a retornar, de 1 a 10. O padrão é 8.
useDomain enum
Mantém apenas os registros que a fonte classifica para este uso. human e veterinary também incluem produtos que a fonte marca como both. Aplicado antes da paginação.

Valores possíveis: human veterinary both unknown not-applicable

species string
Mantém apenas os registros com esta espécie-alvo revisada, como dog (cão), cat (gato), horse (cavalo) ou cattle (bovinos). Registros com espécie desconhecida ou não mapeada são excluídos. Aplicado antes da paginação.

Retorna

country string
O país da busca.
suggestions string[]
Nomes distintos, com as melhores correspondências primeiro.

Erros

400 401 403 429 503 · Erros e limites de requisições

GET /v1/drugs/suggestions
curl -G https://api.medifontis.com/v1/drugs/suggestions \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=br" \
  --data-urlencode "q=dipi" \
  --data-urlencode "limit=8"
Resposta
{
  "country": "br",
  "suggestions": [
    "DIPIDOR",
    "DIPIMED",
    "DIPIREN",
    "DIPIREX",
    "DIPIRONA"
  ]
}