Buscar Medicamento (Vademécum oficial)

Consulta el vademécum oficial del gobierno y devuelve información normalizada del medicamento.

Endpoint GET /v1/medicamentos/buscar

Parámetros (query)

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
q	string	Sí (o code)	paracetamol	Término de búsqueda (nombre, principio activo).
code	string	Sí (o q)	59476	Código de medicamento (opcional).
page	integer	—	1	Paginación (1-based).
per_page	integer	—	20	Resultados por página (máx. 100).

Debe enviar q o code. Si ambos se envían, code tiene prioridad.

Ejemplo - curl

curl -G "https://api.asystir.com/v1/medicamentos/buscar" \
  -H "X-API-Key: TU_API_KEY" \
  -H "X-API-Secret: TU_API_SECRET" \
  --data-urlencode "q=paracetamol" \
  --data-urlencode "page=1" \
  --data-urlencode "per_page=10"

Ejemplo - JavaScript (fetch)

const params = new URLSearchParams({ q: "paracetamol", page: "1", per_page: "10" })
const r = await fetch(`https://api.asystir.com/v1/medicamentos/buscar?${params}`, {
  headers: { "X-API-Key": "TU_API_KEY", "X-API-Secret": "TU_API_SECRET" }
});
console.log(await r.json());

Ejemplo - Visual Basic .NET

Dim client As New HttpClient()
client.DefaultRequestHeaders.Add("X-API-Key", "TU_API_KEY")
client.DefaultRequestHeaders.Add("X-API-Secret", "TU_API_SECRET")
Dim url = "https://api.asystir.com/v1/medicamentos/buscar?q=paracetamol&page=1&per_page=10"
Dim resp = Await client.GetAsync(url)
Console.WriteLine(Await resp.Content.ReadAsStringAsync())

Respuesta de éxito (200)

{
  "success": true,
  "data": {
    "total": 2,
    "page": 1,
    "per_page": 10,
    "items": [
      {
        "code": "59476",
        "nombre": "Paracetamol 500 mg",
        "principio_activo": "Paracetamol",
        "posologia": "1 comprimido cada 8 horas",
        "dosis": "500 mg",
        "presentacion": "Caja x 10 comprimidos",
        "pami_descuento": true,
        "droga": "Paracetamol"
      },
      {
        "code": "59477",
        "nombre": "Paracetamol 750 mg",
        "principio_activo": "Paracetamol",
        "posologia": "1 comprimido cada 12 horas",
        "dosis": "750 mg",
        "presentacion": "Caja x 8 comprimidos",
        "pami_descuento": false,
        "droga": "Paracetamol"
      }
    ]
  }
}

Errores comunes

• 400 Bad Request — Falta q y code.
• 404 Not Found — No hay resultados (devuelve 200 con total:0 preferentemente).
• 500 — Error en servicio externo (vademécum).

Notas

• Los datos provienen del catálogo oficial; puede haber variaciones en nombres o códigos. Implementar caché local si su volumen de consultas es alto.

---