Insights API
Una interfaz que publica lo que publica un informe.
La HABLA™ Insights API es la forma en que una institución lee las señales de HABLA dentro de los sistemas que ya opera —un sistema ejecutivo de distrito, un almacén de datos, la referencia comparativa de una agencia estatal, una plataforma de investigación— sin que una persona copie cifras de una pantalla. Es una interfaz de publicación y no una interfaz de consulta, y ese es todo el diseño.
Una interfaz de publicación, no de consulta
Cada extremo sirve algo que un informe ya representaría.
Una API es, por defecto, una interfaz de consulta, y una interfaz de consulta sin restricciones sobre la actividad anónima es lo único que HABLA ha rechazado por escrito más veces que cualquier otra cosa. HABLA no responde a eso añadiendo reglas a un motor de consultas: responde no construyendo uno.
Cómo se pide una cifra y cómo vuelve
Una institución no compone una pregunta. Elige de una lista publicada, y lo que vuelve es la misma cifra que un informe ya mostraría a quien llama: por eso esta interfaz no tiene motor de consultas que acotar, endurecer o equivocar.
-
Cuatro cosas sin las que se diseñó esta interfaz: una dirección para datos en bruto o por evento, una forma de resolver un tema hasta las personas que lo eligieron, una forma de decir qué organizaciones aportaron a una cifra y un parámetro que baje un umbral. Faltan por diseño y no por estar a medias, y por eso el dibujo le da a esta un contorno punteado en lugar de uno continuo.
-
Una clave de tema del vocabulario publicado, uno de los periodos de reporte publicados y un segmento de la lista declarada. Ni rangos de fechas a elección de quien llama ni combinaciones libres de filtros, por una razón que cabe en una línea: quien puede elegir la ventana puede elegir una segunda que se diferencie de la primera en un solo día.
-
Este es todo el diseño. Una interfaz de consultas sin restricciones sobre la actividad anónima es lo que HABLA ha rechazado por escrito más veces que ninguna otra cosa, y la respuesta no es un motor de consultas con reglas atornilladas encima. Es no construir ninguno.
-
Cifras que han pasado los dos umbrales de reporte y la supresión, para quien nombra la credencial. Una cifra que una institución puede ver en pantalla es una cifra que puede leer aquí, y la que no puede ver falta en las dos. Un valor por debajo de un umbral llega ausente o marcado como retenido, nunca como un número con una bandera al lado y nunca como un cero.
- Los mismos agregados que representa un informe
- Cada extremo sirve cifras que ya pasaron por los dos umbrales de reporte y por la supresión, para la institución que nombra la credencial. Una cifra que una institución puede ver en pantalla es una cifra que puede leer por la interfaz, y la que no puede ver no está en ninguna de las dos.
- Periodos fijos, segmentos fijos
- No hay rangos de fechas elegidos por quien llama ni combinaciones libres de filtros. Se elige entre los mismos periodos y segmentos publicados que ofrece un informe, por una razón que cabe en una línea: quien puede elegir la ventana puede elegir una segunda ventana que se diferencie de la primera en un solo día.
- La supresión, antes de serializar
- Un valor por debajo de un umbral está ausente de la respuesta, o marcado como retenido. Nunca es una cifra real con una marca al lado que el cliente pueda ignorar, y nunca es un cero.
- Un solo juego de reglas, en un solo lugar
- Las reglas de supresión viven en un único paquete de reporte que consumen tanto la consola como la interfaz. Dos implementaciones de un umbral se separan la primera vez que se corrige una de ellas, y un umbral que se separa no es un umbral.
Qué incluye el acceso
Lo que se licencia es el acceso a inteligencia agregada. Nunca es la venta de los datos de conducta de nadie, y esa distinción va en el contrato y no solo en la documentación.
Incluido
- Señales agregadas por tema, ya sometidas a los umbrales
- Comparación entre periodos y horarios de acceso agregados
- Referencias nacionales y por segmento, por encima del umbral de contribuyentes
- El registro de acciones de la propia organización
Qué no se vende, a ningún precio
- Datos anónimos en bruto o por evento
- Cualquier cosa que permita cruzarlos con los datos de recursos humanos del cliente
- Datos del plano de contacto, en cualquier forma
- Un umbral rebajado, un extremo privado o una exportación a medida
La última línea es la que la especificación espera que se ponga a prueba. La primera institución grande que pida un umbral más bajo «solo para nuestra instancia» ofrecerá dinero real por él, y la respuesta ya está escrita: un umbral que se vende por dinero no es un umbral. Ningún umbral, tope ni presupuesto de este sistema puede representarse como una excepción por cliente o por credencial, de modo que no existe un campo donde anotar esa concesión.
Los umbrales que hereda una institución
El acceso no cambia nada de lo que HABLA está dispuesta a publicar. Toda cifra que llega a la interfaz pasó los mismos umbrales que pasa una cifra en pantalla, y una referencia nacional pasa dos más. Son la razón por la que una referencia vale la pena leerla.
- Los dos umbrales de reporte, por organización, antes de compartir nada
- Una organización aporta únicamente lo que ya era reportable para esa organización. Los valores suprimidos no se vuelven reportables por sumarse a los de otras.
- Diez organizaciones contribuyentes, para una cifra nacional o de segmento
- Ninguna cifra entre organizaciones se publica si no contribuyen a ella al menos diez organizaciones independientes. Diez es el número del fundador, y es una constante de plataforma almacenada y no un literal en el código, de modo que vive en un solo sitio y ese sitio no es una consulta.
- Un tope de participación, porque diez no basta por sí solo
- Ninguna organización aporta más del cuarenta por ciento de una cifra. El umbral de recuento evita la divulgación de una sola organización; el tope evita el caso en que diez contribuyen pero una de ellas es casi todo. Hace falta además un límite combinado para las dos o tres mayores, y HABLA no ha fijado ese número: todavía no se ha publicado ninguna cifra entre organizaciones, y el código se niega a publicar una antes que suponer un límite que nadie decidió.
- Un periodo suprimido cuando cambia el conjunto de contribuyentes
- Que una organización entre o salga de un segmento suprime el periodo que enmarca el cambio, en lugar de iniciar una serie nueva con una etiqueta nueva. Cambiar la etiqueta no ayudaría: a la aritmética no le importa que la interfaz se haya negado a dibujar una línea de tendencia.
Contribuir a una cifra nacional es una cláusula aparte que la organización acepta, con la posibilidad de negarse y de retirarse, y negarse no acarrea ninguna penalización en el producto. El motivo es tajante: vender un producto derivado construido con los datos de un cliente sin que eso figure en su acuerdo no es una cuestión de privacidad, es un incumplimiento de contrato.
Cómo se concede el acceso
El acceso se concede mediante un acuerdo escrito y no se emite desde una página. El acuerdo es donde vive el límite: lo que se licencia es el acceso a inteligencia agregada, y eso es una cláusula y no una nota al pie.
- Una conversación, no un alta automática
- No hay llave de autoservicio y no va a haberla. Una institución lo solicita, HABLA y la institución acuerdan qué se licencia y por cuánto tiempo, y se emite una credencial contra ese acuerdo.
- La clase de credencial sigue al acuerdo
- Una organización que lee sus propias cifras y una institución que lee una referencia nacional son acuerdos distintos, atendidos por servicios distintos.
- La contribución se acuerda aparte, o se rechaza
- Que los agregados ya reportables de una organización contribuyan a una cifra nacional es una cláusula propia, y negarse no cuesta nada.
- La revocación es una cláusula, no una solicitud
- Las credenciales se revocan de una en una, y la retirada de la contribución está disponible durante toda la vigencia del acuerdo.
Las clases de credencial se mantienen separadas por arquitectura y no por una rama de validación, ya que un error de validación es la forma más probable de que una llegue a responder alguna vez como la otra. Una credencial de organización queda ligada en el servidor a exactamente una organización, y nunca la nombra quien llama. Una credencial de referencia nacional se sirve desde un servicio aparte que no tiene campo para una organización en ninguna parte: no uno que se niegue a nombrarla, uno que no puede. Las llaves se guardan solo como resumen criptográfico y se revocan de una en una, y el registro de llamadas anota un identificador de credencial y no la llave. La presión que HABLA espera sobre esto no es técnica: es un revendedor pidiendo una sola llave para varios clientes, que llega como una conversación de ventas y no como una revisión de código, y la respuesta queda escrita aquí para que sea pública.
Cuánto cuesta
El acceso parte de $4,500 al año, para una organización que lee sus propias cifras. Lo que eso compra es el acceso descrito en esta página, bajo los umbrales que aparecen en ella, y no compra ninguna excepción a ninguno de ellos. Leer una cifra que abarca varias organizaciones es otro acuerdo, y aquí no se cotiza porque todavía no se ha publicado ninguna.
Para quién es
Las instituciones para las que se está construyendo. Es el público al que se dirige y no una lista de clientes: ninguna organización tiene este acceso y en este sitio no se nombra a ninguna.
- Sistemas escolares y distritos que reúnen señales en un sistema ejecutivo
- Agencias estatales y públicas que consumen una referencia comparativa sin copiar cifras
- Sistemas hospitalarios y organizaciones de salud pública que leen señales de su personal
- Universidades y plataformas de investigación que trabajan a partir de agregados
- Empleadores que conectan señales a las herramientas de reporte que ya usan
Pregunte qué se le permitirá hacer
Casi cualquier proveedor le va a contar qué devuelve su interfaz. A esta pregúntele qué no tiene permitido devolver: llévese cada negativa de esta página a un acuerdo y exíjale a HABLA que lo cumpla. Esa es la pregunta que vale, y es la que esta página está escrita para responder.