Documentação / Guias

Sugestões ao digitar

GET /v1/drugs/suggestions retorna nomes distintos enquanto o usuário digita, para campos de preenchimento automático.

Requisição

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

Resposta
{
  "country": "br",
  "suggestions": [
    "DIPIDOR",
    "DIPIMED",
    "DIPIREN",
    "DIPIREX",
    "DIPIRONA"
  ]
}

Ordenaçã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. As sugestões vêm de todas as fontes, incluindo nomes de princípios ativos e de classificações.

Crie um preenchimento automático ágil

  • Espere até que o usuário tenha digitado pelo menos 3 caracteres.
  • Aplique um debounce de 150 a 250 milissegundos à digitação.
  • Ignore as respostas de buscas que o usuário já alterou.
  • Chame seu próprio backend, que adiciona a chave, em vez de chamar a API Medifontis diretamente.
Navegador
let latest = 0
let timer
input.addEventListener('input', () => {
  clearTimeout(timer)
  const q = input.value.trim()
  if (q.length < 3) return
  timer = setTimeout(async () => {
    const request = ++latest
    const response = await fetch(`/api/medicine-suggestions?q=${encodeURIComponent(q)}`)
    const { suggestions } = await response.json()
    if (request === latest) render(suggestions)
  }, 200)
})