Documentación / Referencia de la API

Referencia de la API

La API de Medifontis es una API REST de solo lectura. Todos los endpoints son GET en un mismo host y devuelven JSON.

URL base

https://api.medifontis.com/v1

Autenticación

Envía tu clave como Authorization: Bearer o como X-Api-Key, nunca de ambas formas. Autenticación.

Endpoints

El objeto de registro

country string
Código de país de dos letras de la fuente.
sourceId string
La fuente de la que procede el registro, como it.aifa.packages.
id string
La identidad del registro dentro de su fuente. Se mantiene estable entre recopilaciones.
kind string
El tipo de registro dentro de la fuente, como packages, ingredients o veterinary-medicines.
name string
El nombre visible del registro: el primero de sus nombres.
names string[]
Todos los nombres por los que se puede encontrar el registro, tomados de sus propios campos.
identifiers object[]
Identificadores tipados con la forma { scheme, value }, como aic, cn, ndc-package o din. Los valores son siempre cadenas.
data object
Los campos normalizados de la fuente, más useDomain y targetSpecies con su evidencia.
region string | null
Una región subnacional cuando la fuente es regional; si no, null.
retrievedAt string
Fecha y hora ISO 8601 en que se obtuvo el registro de su fuente.
sourceUrl string
El conjunto de datos oficial del que se obtuvo el registro.
licence object
La licencia de la fuente: id, url y el texto de atribución que debe mostrarse.
limitations string[]
Lo que la fuente no acredita, como la comercialización actual o la idoneidad para un paciente.

Errores

Los errores devuelven un código de estado y un cuerpo JSON con un mensaje de error. Errores y límites de solicitudes.

Versionado

La versión forma parte de la ruta. Pueden aparecer nuevos campos y parámetros opcionales dentro de v1, así que ignora los campos que no conozcas.

OpenAPI

El contrato completo es un documento OpenAPI 3.1 que puedes cargar en cualquier generador de clientes o herramienta de API. /openapi.json