¿Primera vez? Copia el prompt de inicio para tu agente.

Vitrina · Guía para agentes

Vitrina publica landing pages estáticas (HTML, CSS, JS, imágenes, audio y video) en https://sites.iaparatodos.mx/<slug>/. Cuando el usuario diga «publícalo en Vitrina», «súbelo a Vitrina» o «actualiza la landing en Vitrina», se refiere a este sistema y a esta API. Tú envías los archivos por API; el sistema separa las imágenes en base64, las optimiza, aplica una política de seguridad (CSP) y publica una versión inmutable al instante. Todo cambio se puede revertir.

Inicio rápido

TOKEN=lh_…   # te lo da el operador

# 1. ¿Qué puedo hacer?
curl -s -H "Authorization: Bearer $TOKEN" https://api.iaparatodos.mx/v1/me

# 2. Publicar (crea la landing o una versión nueva)
curl -s -X PUT https://api.iaparatodos.mx/v1/landings/promo-navidad \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "title": "Promo Navidad",
    "note": "Primera versión",
    "files": [
      { "path": "index.html", "content": "<!doctype html><html><head><title>Promo</title><link rel=\"stylesheet\" href=\"css/styles.css\"></head><body><h1>Hola</h1><img src=\"data:image/png;base64,iVBORw0KGgo…\" alt=\"\"></body></html>" },
      { "path": "css/styles.css", "content": "h1{color:#c00}" }
    ]
  }'
# → 201 { "slug": "promo-navidad", "version": 1, "url": "https://sites.iaparatodos.mx/promo-navidad/", "extracted": [...], "optimized": [...], "warnings": [...] }

# 3. Editar un archivo (lee primero el bundle para conocer la versión)
curl -s -H "Authorization: Bearer $TOKEN" https://api.iaparatodos.mx/v1/landings/promo-navidad/bundle
curl -s -X PATCH https://api.iaparatodos.mx/v1/landings/promo-navidad/files \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "base_version": 1, "note": "Cambia el color", "upsert": [ { "path": "css/styles.css", "content": "h1{color:#060}" } ] }'

# 4. Si algo salió mal, vuelve a la versión anterior
curl -s -X POST https://api.iaparatodos.mx/v1/landings/promo-navidad/rollback \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{ "version": 1 }'

Reglas

Slug

Archivos y rutas

Límites

Límite Valor
Archivos por versión 200
Cuerpo JSON 50 MB
Cuerpo multipart 150 MB
Archivo de texto 2 MB
Imagen o fuente 15 MB
Video (MP4, WebM) 100 MB (mejor en YouTube, ver abajo)
Audio (MP3, M4A, OGG, WAV) 30 MB
PDF 25 MB
Medio en base64 dentro del HTML (data:) 15 MB
Cuota por landing 300 MB
Peticiones según tu token (GET /v1/me); 10 escrituras por minuto

Si un archivo grande no cabe en JSON, usa multipart/form-data: cada archivo es una parte y su ruta va en el filename (o en un campo paths con un arreglo JSON en el mismo orden que los archivos).

curl -s -X PUT https://api.iaparatodos.mx/v1/landings/promo-navidad -H "Authorization: Bearer $TOKEN" \
  -F "note=Con video" -F "file=@index.html;filename=index.html" -F "file=@hero.mp4;filename=assets/hero.mp4"

Dónde va cada archivo

Regla: aquí se aloja lo que el navegador muestra o reproduce dentro de la landing. Los videos van, de preferencia, a YouTube; los adjuntos que el visitante solo descarga, a Google Drive; lo demás se convierte antes de subirlo.

Contenido Dónde Cómo usarlo en el HTML
Página, estilos, scripts, imágenes, SVG, fuentes (woff2, woff, ttf, otf) Vitrina Rutas relativas
Video (cualquier duración o formato) YouTube, recomendado <iframe> de youtube-nocookie.com (abajo)
Video corto sin sonido (fondo en bucle, menos de ~10 MB) Vitrina (MP4/WebM) <video autoplay muted loop playsinline>
Audio (testimonios, podcast) Vitrina (MP3, M4A, OGG, WAV) <audio controls src="audio/x.mp3">
Subtítulos Vitrina (VTT) <track kind="subtitles" srclang="es" src="subs/es.vtt">
PDF para ver o descargar Vitrina (hasta 25 MB) <a href="docs/x.pdf" download> o <iframe src="docs/x.pdf">
CSV o JSON que lee el JS de la página Vitrina fetch('datos/precios.csv')
Adjuntos: docx, xlsx, pptx, odt, zip, rar, CSV para descargar, PDF de más de 25 MB Google Drive <a href="https://drive.google.com/file/d/ID/view">
HEIC/HEIF, BMP, TIFF Convertir a JPG, PNG o WebP —
MOV, AVI, MKV y otros videos YouTube (o convertir a MP4 H.264) —
exe, apk, eot, scripts de servidor No se aceptan —

Si mandas un formato que no va aquí, la respuesta 422 unsupported_type trae en hint qué hacer con él.

Video: YouTube es la opción preferida

YouTube transcodifica, adapta la calidad a la conexión del visitante y sirve desde su CDN: la landing carga más rápido y no gasta la cuota de 300 MB. La CSP ya permite sus reproductores; no hace falta pedirle nada al operador.

  1. Si tienes acceso a YouTube, sube el video como No listado. Si no, pide al usuario la URL del video (ya subido como «No listado» o «Público»). No uses videos de terceros sin permiso.
  2. Del enlace (youtu.be/ID, youtube.com/watch?v=ID o youtube.com/shorts/ID) toma el ID e incrústalo así:
<div style="aspect-ratio:16/9">
  <iframe src="https://www.youtube-nocookie.com/embed/ID?rel=0" title="Descripción del video"
    style="width:100%;height:100%;border:0" loading="lazy"
    allow="accelerometer; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
</div>

Adjuntos: Google Drive

Los documentos que el visitante descarga (Office, zip, listas de precios) no se alojan aquí: Google los escanea y los sirve, y así el dominio de las landings queda libre de archivos ejecutables o con macros.

  1. Pide al usuario la carpeta de Drive donde guardarlos, si no te la dio. Sugerencia de organización: una unidad compartida de la empresa (no la cuenta personal de alguien, para que los enlaces no se rompan si esa persona se va) con una subcarpeta por landing: Landings/<slug>/.
  2. Si tienes conector de Drive, sube el archivo ahí; si no, pide al usuario que lo suba y te pase el enlace.
  3. Compártelo como «Cualquier persona con el enlace: lector»; si no, el visitante verá «Solicitar acceso».
  4. Enlázalo con <a href="https://drive.google.com/file/d/ID/view" target="_blank" rel="noopener">. Para descarga directa, https://drive.google.com/uc?export=download&id=ID (en archivos grandes Google muestra antes un aviso).

PDF

Súbelo como archivo (docs/presentacion.pdf) o incrustado en un enlace (<a href="data:application/pdf;base64,…">): en ese caso se extrae a assets/ y no cuenta para el límite del HTML. Puedes mostrarlo dentro de la página con <iframe src="docs/presentacion.pdf" title="Presentación" style="width:100%;height:80vh;border:0">; en móviles, agrega también un enlace de descarga porque muchos navegadores no lo muestran incrustado. <embed> y <object> no están permitidos.

Imágenes y base64

Política de contenido (CSP) y advertencias

Leer y editar

Versiones y ciclo de vida

Reintentos seguros y validación

Errores

Todas las respuestas de error usan application/problem+json (RFC 9457) con un code estable y un hint que dice cómo corregir. Lee el hint antes de reintentar.

{ "status": 422, "code": "type_mismatch", "detail": "assets/foto.png tiene firma JPEG",
  "hint": "Renombra el archivo a .jpg o envía un PNG real.", "path": "assets/foto.png" }
code HTTP Significado Qué hacer
invalid_request 400 La petición no cumple el esquema Revisa el campo indicado en detail; el esquema completo está en /openapi.json.
token_missing 401 Falta el token de acceso Envía la cabecera Authorization: Bearer lh_… (nunca en la query string).
token_invalid 401 Token inválido Comprueba que copiaste el token completo; si se perdió, pide uno nuevo al operador.
token_revoked 401 Token revocado Este token fue revocado por el operador; pide uno nuevo.
token_expired 401 Token caducado Pide al operador un token nuevo; GET /v1/me muestra la caducidad de los tokens vigentes.
ip_not_allowed 403 IP no permitida para este token El token solo acepta peticiones desde las redes que configuró el operador.
forbidden 403 Acción no permitida Recarga la página e inténtalo de nuevo; si persiste, vuelve a iniciar sesión.
insufficient_scope 403 El token no tiene el permiso necesario Consulta tus scopes en GET /v1/me; pide al operador el scope indicado en detail.
slug_not_allowed 403 El token no puede operar sobre este slug Usa un slug que cumpla los patrones de tu token (GET /v1/me → slug_patterns).
not_found 404 Recurso no encontrado Revisa la ruta; la guía está en /llms.txt.
landing_not_found 404 La landing no existe Lista las landings con GET /v1/landings o créala con PUT /v1/landings/{slug}.
version_not_found 404 La versión no existe Puede haberse purgado por retención; consulta GET /v1/landings/{slug}/versions.
file_not_found 404 El archivo no existe en esa versión Consulta el manifiesto con GET /v1/landings/{slug} o el bundle.
version_conflict 409 La landing cambió desde que la leíste Vuelve a leer el bundle de current_version, combina tus cambios y reintenta con base_version = current_version.
slug_reserved 409 El slug está reservado La landing está en la papelera; elige otro slug o pide al operador que la restaure.
upload_gone 410 La URL de carga ya se usó o caducó Crea una URL nueva con POST /v1/uploads (o create_upload_url).
request_too_large 413 La petición es demasiado grande Usa multipart/form-data para binarios grandes, o divide la publicación en un PUT y varios PATCH.
file_too_large 413 Un archivo supera el límite de tamaño Reduce el archivo; los límites están en GET /v1/me → limits.
inline_media_too_large 413 Un medio en base64 (data:) es demasiado grande Envía ese archivo por separado (multipart o una URL de carga) y referéncialo por su ruta.
too_many_files 413 Demasiados archivos en la versión Una versión admite como máximo 200 archivos.
quota_exceeded 413 La landing supera su cuota de almacenamiento Elimina o comprime archivos; la cuota está en GET /v1/me → limits.
unsupported_media_type 415 Content-Type no soportado Usa application/json o multipart/form-data.
invalid_slug 422 Slug inválido Usa 1 o de 3 a 63 caracteres a-z, 0-9 y guiones, sin guion al inicio ni al final, y que no sea una palabra reservada (api, admin, assets, docs…).
missing_index 422 Falta index.html en la raíz Incluye un archivo con path "index.html" (sin carpeta).
invalid_path 422 Ruta de archivo inválida Usa rutas relativas en minúsculas con a-z 0-9 . _ - /, sin "..", sin segmentos que empiecen con ".", hasta 5 niveles y 100 caracteres por nombre.
duplicate_path 422 Ruta duplicada Cada ruta debe aparecer una sola vez (tras pasar a minúsculas y normalizar).
unsupported_type 422 Tipo de archivo no permitido Revisa «Dónde va cada archivo» en /llms.txt: video pesado → YouTube, adjuntos → Drive, el resto se convierte.
type_mismatch 422 El contenido no coincide con la extensión Renombra el archivo con la extensión de su formato real o envía el formato correcto.
invalid_encoding 422 Codificación inválida El base64 debe ser estricto (RFC 4648, sin espacios ni saltos de línea, con relleno "=").
invalid_utf8 422 El archivo de texto no es UTF-8 válido Guarda el archivo como UTF-8 o envíalo como base64 si es binario.
invalid_media 422 Medio incrustado inválido El data: URI declara un tipo que no coincide con su contenido o no está permitido; corrige el MIME o extrae el archivo.
image_too_large 422 La imagen tiene demasiados píxeles Reduce la imagen por debajo de 50 megapíxeles antes de subirla.
gif_too_large 422 GIF animado demasiado pesado Convierte la animación a MP4 o WebM y usa
invalid_image 422 No se pudo procesar la imagen El archivo parece dañado; vuelve a exportarlo.
invalid_svg 422 SVG inválido El SVG no se pudo analizar; vuelve a exportarlo como SVG estándar.
invalid_video 422 Video inválido Solo se aceptan MP4 (ftyp) y WebM (EBML) reales.
path_not_found 422 La ruta a borrar o renombrar no existe Lee el manifiesto actual y usa rutas existentes en delete y rename.from.
nothing_to_change 422 El parche no contiene operaciones Incluye al menos un elemento en upsert, delete o rename.
idempotency_key_reused 422 La Idempotency-Key ya se usó con otro cuerpo Genera una clave nueva para cada operación distinta.
landing_disabled 423 La landing está deshabilitada El operador bloqueó esta landing; no acepta escrituras hasta que la habilite.
rate_limited 429 Demasiadas peticiones Espera los segundos indicados en Retry-After antes de reintentar.
busy 429 El servidor está procesando otras publicaciones Reintenta tras los segundos de Retry-After con la misma Idempotency-Key.
processing_timeout 504 El procesamiento excedió el tiempo máximo Reduce el tamaño o número de imágenes; sube los videos por multipart o URL de carga.
internal 500 Error interno Reintenta con la misma Idempotency-Key; si persiste, avisa al operador con el request_id.

MCP

El servidor MCP (https://api.iaparatodos.mx/mcp, mismo token) llega en la fase 2 con herramientas equivalentes a esta API.

Seguridad

También en /llms.txt (markdown) y /openapi.json.