{
  "servicio": "API Pública ABEAS DATA®",
  "version": "v1",
  "metodologia_version": "1.0",
  "estado": "preparada",
  "descripcion": "Servicio de solo lectura que expone exclusivamente indicadores AGREGADOS del sector salud. Nunca publica datos individuales ni información personal.",
  "casos_de_uso": [
    "Investigación",
    "Academia",
    "Entidades públicas"
  ],
  "autenticacion": {
    "tipo": "Bearer token (preparado)",
    "nota": "Los endpoints agregados son públicos de solo lectura. La emisión de tokens y las cuotas por consumidor se activarán para usos de alto volumen."
  },
  "limites": {
    "ventana": "1 minuto",
    "solicitudes_por_ip": 60,
    "nota": "Límite orientativo aplicado por mejor esfuerzo. Puede ajustarse por acuerdo institucional."
  },
  "endpoints": [
    {
      "metodo": "GET",
      "ruta": "https://abeasdata.com/api/public/v1",
      "descripcion": "Documentación del servicio y diccionario de indicadores."
    },
    {
      "metodo": "GET",
      "ruta": "https://abeasdata.com/api/public/v1/indicadores",
      "descripcion": "Panorama nacional agregado y serie histórica nacional del Índice ABEAS®."
    }
  ],
  "diccionario": [
    {
      "clave": "indice_abeas",
      "nombre": "Índice ABEAS®",
      "unidad": "puntos",
      "rango": "0 – 100",
      "granularidad": [
        "nacional",
        "territorial",
        "institucional"
      ]
    },
    {
      "clave": "experiencia_usuario",
      "nombre": "Experiencia de usuario",
      "unidad": "porcentaje",
      "rango": "0 – 100",
      "granularidad": [
        "nacional",
        "territorial",
        "institucional"
      ]
    },
    {
      "clave": "experiencia_trabajador",
      "nombre": "Experiencia del trabajador",
      "unidad": "dias",
      "rango": "0 – 45 días",
      "granularidad": [
        "nacional",
        "territorial",
        "institucional"
      ]
    },
    {
      "clave": "gestion_institucional",
      "nombre": "Gestión institucional",
      "unidad": "porcentaje",
      "rango": "0 – 100",
      "granularidad": [
        "nacional",
        "territorial",
        "institucional"
      ]
    },
    {
      "clave": "calidad_dato",
      "nombre": "Calidad del dato",
      "unidad": "puntos",
      "rango": "0 – 100",
      "granularidad": [
        "nacional",
        "territorial",
        "institucional"
      ]
    },
    {
      "clave": "oportunidad_pago",
      "nombre": "Oportunidad de pago",
      "unidad": "dias",
      "rango": "≥ 0 días",
      "granularidad": [
        "nacional",
        "territorial",
        "institucional"
      ]
    },
    {
      "clave": "participacion",
      "nombre": "Participación ciudadana",
      "unidad": "conteo",
      "rango": "≥ 0",
      "granularidad": [
        "nacional",
        "territorial",
        "institucional"
      ]
    },
    {
      "clave": "pqrs_total",
      "nombre": "PQRS registradas",
      "unidad": "conteo",
      "rango": "≥ 0",
      "granularidad": [
        "nacional",
        "territorial",
        "institucional"
      ]
    }
  ],
  "aviso": "Todos los cálculos oficiales son matemáticos y auditables. Sin inteligencia artificial."
}