Un esquema unificado significa que todas las plataformas de una API responden con la misma forma. Pide un perfil en una red o en otra y recibes los mismos nombres de campo en los mismos sitios, así que tu código tiene un parser en lugar de diez.
Es un ahorro real. Es también el sitio más fácil de un producto de datos para contar una pequeña mentira a gran escala.
Qué resuelve de verdad
Las plataformas no se ponen de acuerdo en nada. Una lo llama followers_count, otra followerCount, otra lo mete tres niveles dentro de un bloque de hidratación. Una devuelve una marca de tiempo ISO, otra una época Unix, otra una cadena relativa. Normalizar eso una vez, de forma centralizada, y probarlo es un trabajo que no debería repetirse en cada cliente.
La primera forma de mentir: inventar un campo
Si una plataforma no expone algo, un esquema unificado tiene tres opciones para esa clave:
| Opción | Qué lee quien consume |
|---|---|
| Omitir la clave | "Esta plataforma es distinta" — pero ahora la forma no está unificada |
Devolver null |
"No tenemos esto" |
Devolver 0 o false |
"Esta cuenta no tiene nada" — una afirmación que la plataforma nunca hizo |
La tercera es la mentira, y es popular porque evita que los paneles muestren huecos. Un false en un campo de verificación dice que la cuenta no está verificada. Un null dice que nadie lo sabe. En una red federada no hay verificación de identidad en absoluto — solo verificación de enlace —, así que cualquier booleano en ese campo está afirmando algo que la plataforma no mide.
La segunda forma de mentir: aplanar cosas distintas
Una estrella no es un "me gusta". Un repositorio no es una publicación. Un impulso no es algo que la cuenta escribió. Cuando un esquema mapea todo eso a metrics y posts_count porque la forma exige un número ahí, la forma ha empezado a producir ficción.
El manejo honesto es dejar el campo en null y decir por qué, que es lo que hace cada una de nuestras páginas de ruta en una sección titulada qué no devuelve este endpoint — por ejemplo la ruta de perfil de GitHub, donde el número de publicaciones se queda en null porque un repositorio no es una publicación.
Cómo evaluar uno
Pregúntale a un proveedor qué campos vuelven null para qué plataformas, y por qué. Un proveedor que ha medido sus fuentes puede responder campo por campo. Uno que no puede te mandará una tabla de cobertura con marcas en todas las celdas, que es la respuesta que debería preocuparte.