POST
/api/mod/landing/{espacio}/landings/{landing}/validarValida un HTML editado a mano
Si retocaste la landing por tu cuenta, mándala aquí: Bentho la vuelve a probar y repara lo que falle sin cambiar su contenido. Sin html, valida la última versión.
- PERMISOescribe
- CRÉDITOSgasta créditos
- 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). |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| html | string | no | El documento completo, de <!DOCTYPE html> a </html>. Hasta 300 000 caracteres. Parte del html de GET …/html. |
| formConfig | object | no | El formulario: campos, mensaje de éxito, botones y redirección. Su forma, en la guía. |
RESPUESTA 202
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id | string | El id de la landing. |
| version | integer | El número de la versión que se encoló. |
| trabajo | string | El id de esa versión. Para seguirla te basta con id y version. |
| status | "pendiente" | Siempre pendiente al encolar. |
| base | integer | La última versión con HTML. |
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. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 402 | La cuenta agotó sus créditos del ciclo | La cuenta de este espacio agotó sus créditos de este ciclo. |
| 404 | No hay una landing con ese id en el espacio (o se borró) | La landing no existe |
| 409 | La landing ya tiene una versión en curso: espera o cancélala | La landing ya tiene una versión en curso. |
| 409 | Ninguna versión tiene HTML todavía | La landing todavía no tiene una versión sobre la que trabajar. |
| 422 | html no empieza por <!DOCTYPE html> | html debe ser un documento completo (<!DOCTYPE html>…</html>) |
| 429 | El espacio tiene demasiadas landings generándose a la vez | Hay demasiadas landings en curso en este espacio; espera a que terminen. |
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
- Responde enseguida: el trabajo sigue en segundo plano y suele tardar unos minutos. Sigue la versión con GET landings/{landing}.