Últimos cambios
Novedades de la API pública.
Publicar, aprobar y des-publicar por API
Tres endpoints nuevos con su propio scope `content:manage`: publicar una versión concreta, aprobar el candidato del workflow editorial y dejar de servir una ficha. El scope es aparte de `catalog:write` a propósito — escribir la ficha y decidir qué sirve tu tienda son cosas distintas.
Historial de la ficha: qué cambió en un producto y cuándo
GET /v1/products/{product_id}/revisions devuelve las versiones de una ficha, de la más reciente a la más antigua, con qué cambió en cada una: campos, atributos (por código e idioma), categorías y familia. De los datos importados se reportan los nombres de las columnas que cambiaron, nunca su contenido. Para el integrador que sincroniza y quiere saber qué mirar sin volver a descargar la ficha entera.
Canales: qué columnas son requeridas y cuántos productos están listos
GET /v1/channels ahora trae `columns[].required` y `skip_incomplete` (si el canal omite las filas incompletas de su CSV y su feed). Y GET /v1/channels/{slug}/readiness dice cuántos productos saldrían completos en el canal, cuántos no tienen ficha publicada y qué columnas requeridas faltan más — con el mismo criterio que el archivo.
El objeto 3D del producto, en el mismo endpoint de medios
GET /v1/products/{id}/media puede traer un cuarto rol: model_3d. Su url es el GLB y el campo nuevo usdz_url es el mismo modelo en USDZ, lo único que abre Quick Look en iPhone; en una imagen o un video es null. Aditivo: si ya integras, tu contrato no cambia — pero elige la imagen base por role, no por el índice 0.
El código del atributo en tu tienda
GET /v1/attributes devuelve external_code: el attribute_code con el que Adobe Commerce conoce cada atributo, capturado en Bruxel. Cuando existe, /v1/export/catalog.csv nombra así la columna en vez de con code. null = sin código externo; nada cambia.
Video por API: clips de hasta 30 segundos, con guion
POST /v1/products/{id}/ai-video arranca un clip a partir de una imagen ya guardada del producto: cinco segundos con tarifa plana, o hasta 30 con audio cobrados por segundo × calidad. Con ai_model_id la misma modelo sale en todos los cortes. POST /v1/products/{id}/ai-video/script escribe el guion por tomas con IA (3 créditos, al éxito).
El look de cada foto: peinado, maquillaje y vestuario
POST /v1/products/{id}/ai-media acepta hairstyle, makeup y outfit para dirigir cómo se ve la modelo en ESA foto, sin tocar su identidad. Los tres abren en as_model y con ese valor nada cambia respecto a lo de antes; el job los devuelve en look.
Ropa y expresión en la generación de imágenes
POST /v1/products/{id}/ai-media acepta subject (product | garment) para que la modelo se ponga la prenda en vez de sostenerla, y expression (natural, smile, laugh, neutral, serious, playful) para elegir su cara. Los dos son opcionales y su default reproduce el comportamiento anterior; el job los devuelve en subject y expression.
Imágenes: feed de cambios, webhook y generación por API
GET /v1/media/deltas dice qué productos movieron su galería (incluidos los borrados); el evento media.updated avisa en tiempo real; GET /v1/products/{id}/media trae el rol real (aparece swatch), la posición y la procedencia (origin, synthetic_performer); y con el scope nuevo media:generate se abren sesiones de fotos con IA desde tu sistema (POST /v1/products/{id}/ai-media, GET /v1/ai-media/jobs/{id}, GET /v1/ai-models).
API keys por organización
Nuevas llaves bxk_ con permisos por scope (catalog:read, generate, export…), entrega de un solo uso y revocación inmediata desde la consola.
Lotes asíncronos con idempotencia
Endpoint POST /v1/batches para timbrar en volumen: reserva de créditos, Idempotency-Key obligatoria y cobro por resultado al leer.
Export de catálogo por idioma
GET /v1/export/catalog.csv?language=es devuelve tu catálogo timbrado en el idioma solicitado, compatible con Adobe Commerce y Shopify.