Saltar al contenido
API v1 · https://bentho.org/api
GET/api/mod/landing/{espacio}/landings/{landing}/html

El 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

CAMPOTIPOREQUERIDOQUÉ ES
espaciostringSÍEl id del espacio (sale en GET /api/companies). Tiene que tener el módulo Landings.
landingstringSÍEl id de la landing: el que devolvió crearla (32 caracteres hexadecimales).
versionint, querynoUna versión concreta.

RESPUESTA 200

CAMPOTIPOQUÉ ES
versionintegerLa versión que te da.
htmlstringUn documento completo, en un solo archivo y con su formulario conectado. Publícalo tal cual.
calidadobject | nullSu certificado (abajo). Publica lo que tenga status: "approved"; lo demás, revísalo antes.

CALIDAD

CAMPOTIPOQUÉ ES
status"approved" | "needs_review" | "failed"approved solo si pasó las dos revisiones.
motivosstring[]Por qué no se aprobó. Vacío si se aprobó.
emitidostring | nullCuándo, en ISO 8601.
html_sha256string | nullEl SHA-256 del HTML que certifica. Vale para ese HTML exacto: si lo cambias, mándalo a validar.
funcionalobject | nullLa revisión de funcionamiento: status (passed o needs_review), brief_cumplido, los escenarios que probó y sus hallazgos.
visualobject | nullLa 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": …}

STATUSCUÁNDODETAIL LITERAL
403El espacio no tiene el módulo Landingsmódulo no habilitado para este espacio.
404No hay una landing con ese id en el espacio (o se borró)La landing no existe
404Esa versión no existeLa versión no existe
409Sin version: ninguna versión tiene HTML todavíaLa landing todavía no tiene HTML
409Esa versión no tiene HTML (en curso, fallida o cancelada)La versión todavía no tiene HTML
422version no es un númeroversion 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_html deje de ser null en el estado.