<!-- Universal Web · versión Markdown para agentes de IA · HTML: https://universal-web.healthpoint-suite.es/blog/un-back-muchos-fronts-el-contrato-json -->

# Un back, muchos fronts: el contrato JSON

Publicado: 2026-11-15 · Equipo Universal Web

> Cada página es una lista de bloques y cada entrada un objeto JSON: así puedes montar el front que quieras sobre el mismo back.

## El contrato

Una página de Universal Web no es HTML: es una **lista de bloques**. Cada bloque tiene un `type` y unos `data` con campos conocidos, descritos en `/api/schema.json`.

```json
{ "type": "hero", "data": { "title": "Hola", "subtitle": "Mundo" } }
```

## Endpoints públicos

- `/api/site.json`: datos de la web y lista de páginas.
- `/api/pages/{slug}.json`: una página con sus bloques.
- `/api/posts.json`: entradas del blog, con paginación y filtro por etiqueta.
- `/api/posts/{slug}.json`: una entrada completa, con su HTML ya generado.
- `POST /api/contact`: recibe mensajes del formulario.

## Un front con HTML y JS

Para demostrar que no hay magia, incluimos un ejemplo mínimo en [/examples/headless.html](/examples/headless.html): un front alternativo que lee la API y pinta los bloques en el navegador.

Gracias a esto puedes usar los temas PHP incluidos, un front en React o Astro, o incluso una app móvil, y **todos comparten el mismo panel y el mismo MCP**.
