Registro de cambios y versiones

VersionesCopiar link a esta sección

La versión de la API va en la ruta: /v1. Dentro de una versión, en cualquier momento podemos:

• agregar endpoints,
• agregar campos a las respuestas,
• agregar campos opcionales a las solicitudes,
• agregar valores a los enums documentados como abiertos (tipos de destino, propiedades de escaneo).

Escribe clientes que ignoren los campos y los valores de enum desconocidos. Todo lo que rompería un cliente correcto, como eliminar un campo o cambiar su tipo, se publica como una nueva versión mayor, con al menos tres meses de convivencia durante los cuales funcionan ambas versiones, y se anuncia aquí.

Registro de cambiosCopiar link a esta sección

2026-10-19Copiar link a esta sección

• POST /v1/design/preview acepta un logo opcional, con la misma forma que en POST /v1/codes, para que la vista previa muestre el logo del centro antes de guardar nada. Un logo de vista previa no se agrega a la Biblioteca; se agrega al guardar un código con él.
• GET /v1/templates?images=wordless devuelve las plantillas propias de KuikCode con una imagen sin las palabras de su marco y su centro, para pantallas que muestran cada nombre como texto al lado. Las plantillas guardadas conservan su propia imagen.

2026-10-02Copiar link a esta sección

• El plan de los bloques del creador de páginas informa basic donde antes informaba free: el nivel más bajo ahora es el conjunto link-in-bio del plan Basic (Encabezado, Botones, Redes sociales, Texto enriquecido, Título, Imagen, Divisor, Mapa y dirección).
• Los bloques Fotos de invitados, Link de música y Embudo de reseñas informan pro; Formulario informa core (antes informaba pro), y Fotos de invitados antes informaba core. El webhookUrl de un formulario requiere PRO (antes requería Business).
• Guardar una página en un plan que no incluye alguno de sus bloques sigue funcionando para los bloques que la página ya tiene; solo se rechaza agregar uno nuevo (403). Publicar sigue requiriendo que todos los bloques estén en el plan.

2026-10-01Copiar link a esta sección

• workspace.plan en GET /v1/me suma basic y core, y starter pasa a ser core. Ningún espacio de trabajo estaba en Starter, porque durante la beta no se podían comprar planes.
• El plan de los bloques del creador de páginas informa core donde antes informaba starter.

2026-09-28Copiar link a esta sección

• Scan.code suma name, así que un escaneo se puede reportar sin una segunda consulta.
• Submission suma fields: las respuestas identificadas por la etiqueta de cada campo, igual que las envían los webhooks de formularios. data sigue identificado por el id del campo.

2026-09-26Copiar link a esta sección

• Creación de KuikPages: GET /page-templates, POST /pages (desde una plantilla curada o guardada), GET /pages/{id}/content, POST /pages/{id}/edits (operaciones de edición protegidas por la revision de la página; una revisión desactualizada responde 409), POST /pages/{id}/publish y GET /page-blocks para los campos de cada tipo de bloque.
• Imágenes: POST /images guarda en la Biblioteca una imagen desde una URL o en base64; GET /stock/photos y POST /stock/photos/{id}/import buscan e importan fotos de stock gratuitas.

2026-09-25Copiar link a esta sección

• Sitios alojados: GET /sites, GET /sites/{id}, POST /sites para publicar un ZIP en {subdomain}.kuik.page, POST /sites/{id}/deploy para volver a publicar en el mismo lugar y POST /sites/uploads para preparar los ZIP de más de unos 3 MB.
• POST /images/generate crea una imagen a partir de una descripción en texto y la guarda en la Biblioteca; se mide con las imágenes generadas con IA mensuales del plan.
• GET /me suma limits.sites, limits.aiImages, usage.sites y usage.aiImages.

2026-09-08Copiar link a esta sección

• Las entregas de webhooks entran en cola y se reintentan: hasta cinco intentos ante tiempos de espera agotados y respuestas 408, 425, 429 y 5xx, respetando Retry-After. Cada intento lleva X-KuikCode-Delivery (estable por evento) y X-KuikCode-Timestamp.
• Nuevo formato de firma: X-KuikCode-Signature: t=<unix>,v1=<hex>, el HMAC-SHA256 de <t>.<body>. La forma anterior sha256=<hex> ya no se envía; actualiza tu verificador antes de poner en marcha códigos con webhooks.
• GET /webhooks/deliveries, GET /webhooks/{id}/deliveries y POST /webhooks/deliveries/{deliveryId}/retry exponen el historial de entregas.
• POST /webhooks/{id}/secret muestra el secreto y POST /webhooks/{id}/rotate-secret lo rota con 24 horas de convivencia. Los GET /webhooks y GET /webhooks/{id} normales ya no incluyen secret.
• Webhook suma enabled y secretRotatedAt; PATCH /webhooks/{id} acepta enabled para pausar y reanudar las entregas.

2026-09-06Copiar link a esta sección

• Lanzamiento inicial de v1: espacio de trabajo (/me), códigos con descarga del diseño, carpetas, plantillas, escaneos y analítica, respuestas de formularios, webhooks y KuikPages de solo lectura.