GEgetjusto
Páginas HTML

Crear preview inmutable de un cambio

Changed on

Operación limitada al sitio autorizado; requiere permiso admin en la API. En MCP se valida website.edit. Consulta creation-skill para el flujo completo. Las cargas y previews son temporales; Con el experimento website-page-editor/enabled, apply guarda un borrador compartido; publish publica explícitamente con revision, baseRevision y operationId estable entre reintentos. Sin el experimento, apply conserva su publicación directa. Ambos requieren confirmed: true. Preview acepta zipUploadId (ZIP de HTML e imágenes), htmlUploadId o html, exactamente uno. ZIP hasta 100 MB comprimidos/descomprimidos, 128 entradas, un HTML y hasta 30 imágenes. ZIP usa sus imágenes y no admite el parámetro assets; recompila Tailwind. Al editar, omitir assets/dynamicFields conserva sus mapas; enviarlos los reemplaza por completo. Solo páginas completas con un componente HTML. replace_page elimina todos los componentes anteriores. Si cambia cualquier componente desde su lectura, requiere otro preview.

post/ecommerce/page-previews

Request

  • Base URL
    https://api.service.getjusto.com/v3
  • Auth
    none declared

Request body

zipUploadIdstring

ID de un ZIP ya subido mediante create_page_uploads con application/zip. Incluye HTML e imágenes; no requiere mapa assets. Envía exactamente uno de zipUploadId, htmlUploadId o html.

htmlUploadIdstring

Alternativa a html: ID de un archivo HTML ya subido. Envía exactamente uno de html, htmlUploadId o zipUploadId.

htmlstring

Fragmento HTML completo. Alternativa al ZIP: no requiere upload. Excluye htmlUploadId y zipUploadId.

assetsobject

Mapa completo de rutas del HTML a uploadId/assetId de imágenes. Al editar, omitir conserva el mapa anterior; {} lo vacía. Usa los IDs devueltos por uploads o list_website_assets.

dynamicFieldsobject

Opcional: valores de los campos {{ ... }}. Al editar, omitir conserva los valores actuales; si se envía reemplaza el mapa completo.

Response

Resultado de la operación. Los listados devuelven items y nextOffset; uploads devuelve uploads con uploadId, path, uploadUrl, method, headers y expiresAt; preview devuelve previewId, previewUrl, expiresAt, assets, replacesEntirePage, published=false y publishRequiresConfirmation=true; apply devuelve pageId, pageUrl y previewId. get devuelve page y content: format html incluye solo revision, sin HTML ni descargas; format unsupported incluye revision, canReplace y un aviso sin exponer componentes. Los listados incluyen content.format. content devuelve format, revision, downloadUrl, expiresAt y files para HTML; unsupported devuelve el aviso y un ZIP en blanco con isBlank=true, HTML/CSS compilado vacíos, mapas vacíos y el target para reemplazar la página. HTML compatible lleva isBlank=false. El ZIP incluye HTML, CSS compilado, assets gestionados, Tailwind y manifiesto; las dependencias externas se enumeran. La descarga vence en 10 minutos.

successboolean
dataobject

Changes