Páginas públicas
Crea una página HTML, publícala, compártela y actualízala después.
Una página pública es una página publicada con su propio historial de versiones. Un script la crea, la publica y comparte un enlace. Después reemplaza el borrador y publica de nuevo; el enlace compartido muestra automáticamente la nueva versión.
La URL base correcta
Los scripts con clave API hablan con https://api.adlass.io/v1 (desarrollo: https://dev.adlass.io/v1). Las rutas …/api/v1/operations/<key>/invoke/ pertenecen a la aplicación web y al servidor MCP y no aceptan claves API; responden con route_not_found.
Crear la página
La clave necesita pages:write. html es un documento HTML completo (máx. 5 MiB); settings.locale define el idioma de la página.
curl https://api.adlass.io/v1/pages \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d @- <<'JSON'
{"space_id":"SPACE_UUID","kind":"html","name":"Informe trimestral",
"html":"<!doctype html><html><body><h1>Q3</h1></body></html>",
"settings":{"locale":"es","show_brand":false}}
JSONLa respuesta es el borrador (status: DRAFT). Guarda el id.
Publicar y crear un enlace
POST /pages/{page_id}/publish congela el borrador como versión 1. Luego, POST /pages/{page_id}/links crea un enlace para compartir; la respuesta contiene la url pública una sola vez.
curl -X POST https://api.adlass.io/v1/pages/PAGE_UUID/publish \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"
curl https://api.adlass.io/v1/pages/PAGE_UUID/links \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"label":"Junta directiva","submission_mode":"NONE","locale":"es"}'Actualizar y publicar de nuevo
PUT /pages/{page_id}/draft con un html nuevo reemplaza el borrador. Otro publish genera la versión 2. Por defecto los enlaces siguen la versión más reciente: el enlace que ya enviaste muestra el contenido nuevo sin ninguna llamada adicional. La respuesta de publish lista los enlaces movidos en retargeted_link_ids.
curl -X PUT https://api.adlass.io/v1/pages/PAGE_UUID/draft \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"html":"<!doctype html><html><body><h1>Q3, corregido</h1></body></html>"}'
curl -X POST https://api.adlass.io/v1/pages/PAGE_UUID/publish \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"Si quieres que un enlace se quede en una versión específica, créalo con "pinned": true o apúntalo a una versión con POST /page-links/{link_id}/retarget; eso lo fija. PATCH /page-links/{link_id} con "pinned": false hace que vuelva a seguir la versión más reciente.
Sigue leyendo
Idempotencia para reintentos seguros, la referencia para todos los campos de páginas y enlaces.