POST
/api/mod/landing/{espacio}/landings/{landing}/restaurarVuelve a una versión anterior
Crea una versión nueva, ya terminada, con el HTML y el certificado de la que elijas. Pasa a ser la última: la que se entrega y la base del siguiente refinado. No se borra nada.
- PERMISOescribe
- 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). |
CUERPO · JSON
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| version | integer | SÍ | La versión a la que vuelves: una con con_html que no sea la última. |
RESPUESTA 201
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id | string | La landing. |
| version | integer | El número de la versión nueva. |
| status | "aprobado" | "revision" | aprobado si la versión de origen lo estaba; si no, revision. |
| restaurada_de | integer | La versión que copió. |
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. |
| 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 | La landing ya tiene una versión en curso: espera o cancélala | La landing ya tiene una versión en curso. |
| 409 | Esa versión no tiene HTML (en curso, fallida o cancelada) | Esa versión no tiene una landing que restaurar. |
| 409 | Pides la versión que ya es la última | Esa ya es la versión actual. |
| 422 | version no es un entero mayor que 0 | version debe ser un número de versión |
| 422 | Mandas otro campo | Campos no admitidos: … |
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
- No gasta créditos y funciona aunque la bolsa esté agotada: copia, no genera. Responde con la versión ya terminada; no hace falta consultar el estado.
- El certificado sigue valiendo porque el HTML es el mismo, byte a byte: su
html_sha256no cambia.