GET
/api/mod/landing/{espacio}/landings/{landing}/htmlEl HTML de una landing
El HTML listo para publicar, con su certificado de calidad. Sin version, la última aprobada; si ninguna lo está, la última que tenga HTML.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Landings. |
| landing | string | SÍ | El id de la landing: el que devolvió crearla (32 caracteres hexadecimales). |
| version | int, query | no | Una versión concreta. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| version | integer | La versión que te da. |
| html | string | Un documento completo, en un solo archivo y con su formulario conectado. Publícalo tal cual. |
| calidad | object | null | Su certificado (abajo). Publica lo que tenga status: "approved"; lo demás, revísalo antes. |
CALIDAD
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| status | "approved" | "needs_review" | "failed" | approved solo si pasó las dos revisiones. |
| motivos | string[] | Por qué no se aprobó. Vacío si se aprobó. |
| emitido | string | null | Cuándo, en ISO 8601. |
| html_sha256 | string | null | El SHA-256 del HTML que certifica. Vale para ese HTML exacto: si lo cambias, mándalo a validar. |
| funcional | object | null | La revisión de funcionamiento: status (passed o needs_review), brief_cumplido, los escenarios que probó y sus hallazgos. |
| visual | object | null | La revisión de diseño, en escritorio y en móvil: status, el umbral y una nota de 0 a 100 en cada una de sus dimensiones (hierarchy, composition, typography, spacing, consistency, legibility, imagery, mobile). Para aprobar, todas llegan al umbral. |
| hallazgos[] | { severidad, descripcion, correccion } | Lo que encontró cada revisión. severidad es blocker, major o minor; solo los minor dejan aprobar. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Landings | módulo no habilitado para este espacio. |
| 404 | No hay una landing con ese id en el espacio (o se borró) | La landing no existe |
| 404 | Esa versión no existe | La versión no existe |
| 409 | Sin version: ninguna versión tiene HTML todavía | La landing todavía no tiene HTML |
| 409 | Esa versión no tiene HTML (en curso, fallida o cancelada) | La versión todavía no tiene HTML |
| 422 | version no es un número | version inválido |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- Un 409 aquí no es un error de tu lado: la versión aún no termina. Espera a que
version_con_htmldeje de sernullen el estado.