Funciones
Sitios webPortafolioMediosConservaciónEntrega a clientesCursosComercioEquipo
FundamentosSolucionesPrecios
DocumentaciónAPI para desarrolladoresSoftwareGuías
Acerca de
Acerca deCompromisoSala de prensa
Iniciar sesión
ArtInStack

El sistema operativo creativo

Producto

  • Resumen de funciones
  • Sitios web
  • Portafolio
  • Medios
  • Conservación
  • Entrega a clientes
  • Cursos
  • Comercio
  • Equipo
  • Soluciones

Recursos

  • Guías
  • Software
  • Documentación
  • API para desarrolladores
  • Fundamentos de la plataforma
  • Precios
  • Registro de cambios
  • Hoja de ruta

Acerca de

  • Acerca de
  • Compromiso
  • Sala de prensa
  • Estado
  • Habla con nosotros

Acceso de clientes

© 2026 ArtInStack. Todos los derechos reservados.

Política de privacidadTérminos del servicio

ArtInStack Developer Platform

Build custom integrations, automate workflows, and connect official clients like Lightroom Classic using the ArtInStack HTTP API. Open API reference.

API para desarrolladores
  • Descripción general
  • Autenticación
  • OAuth 2.0
  • Tokens de acceso personal
  • Ámbitos
  • Errores
  • Idempotencia
  • Medios
  • Portfolios
  • Lightroom Classic
  • Capture One
  • Photoshop
  • Ajustes de desarrollador
API reference
API para desarrolladores

Photoshop

Instala el plugin UXP ArtInStack, Connect con Device Code, elige un portfolio y publica el documento activo desde Adobe Photoshop.

Esta es la guía de integración del plugin UXP oficial de Photoshop. Referencia de API: OAuth, Medios, Portfolios.

Requisitos previos

  • Adobe Photoshop 23+ (UXP)
  • Creative Cloud Desktop (para instalar el .ccx)
  • Cuenta de ArtInStack con al menos un portfolio creado en el panel
  • .ccx desde Software

Instalación

  1. Descarga ArtInStack-Photoshop-latest.ccx desde Software
  2. Haz doble clic en el .ccx (o ábrelo con Creative Cloud Desktop) para instalarlo en Photoshop
  3. Reinicia Photoshop si el panel no aparece
  4. Abre Plugins → ArtInStack

Beta privada / desarrollo: carga manifest.json con UXP Developer Tools en lugar del .ccx.

Conectar (Device Code)

Photoshop UXP no puede enlazar un listener HTTP en loopback, así que el plugin usa OAuth 2.0 Device Authorization Grant (no Authorization Code + PKCE).

  1. En el panel ArtInStack, haz clic en Connect
  2. El plugin solicita un device code y abre /oauth/device en el navegador
  3. Inicia sesión si se te pide, introduce el código de usuario mostrado en el panel (si se solicita) y aprueba los ámbitos
  4. El plugin hace polling a /api/oauth/token hasta la aprobación y guarda access + refresh tokens
  5. Apps conectadas en Ajustes → Desarrollador lista ArtInStack Photoshop tras el consentimiento

Elegir un portfolio

  1. Tras Connect, el panel carga GET /api/v1/portfolios
  2. Elige el portfolio para esta publicación
  3. Crea portfolios en el panel de ArtInStack. El plugin no los crea

Publicar

  1. Abre el documento que quieres publicar (el máster)
  2. Ajusta Export settings en el panel si hace falta (los valores por defecto coinciden con el tamaño web de Lightroom / Capture One)
  3. Haz clic en Publish active document. El plugin prepara un JPEG y lo sube vía POST /api/v1/media con Idempotency-Key y portfolio_id
  4. Si tiene éxito, la foto aparece en el portfolio del panel; el log del panel muestra media_id

Los tipos admitidos por la API (JPEG, PNG, GIF, WebP, TIFF) están en Medios. El panel publica solo JPEG hoy.

Ajustes de exportación (v0.1.1+)

AjustePredeterminadoNotas
ResizeOn — 2048 pxLado más largo (alternativas: lado corto, ancho, alto, px personalizado)
Convert to sRGBOnColor web/portfolio
Embed profileOnCon conversión a sRGB
Duplicate imageOnTrabaja en una copia; el máster nunca se modifica
Convert to 8-bitOnRuta JPEG
SharpeningLightLight o Screen Smart Sharpen en una capa stamped; None para omitir
JPEG qualityHigh (~10)Escala UXP 1–12

Qué ocurre al publicar (Duplicate on)

  1. Photoshop duplica el documento activo y ejecuta los pasos de exportación solo en la copia (8-bit, sRGB, resize, merge visible, stamp de nitidez opcional)
  2. El plugin escribe {document-basename}-copy.jpg y lo sube
  3. La copia procesada permanece abierta para que puedas inspeccionar capas, ajustar la opacidad de nitidez en Capas (ArtInStack sharpen) o Save As en local
  4. La copia se abre al 100% de zoom, o Fit on Screen cuando el lienzo es mayor que la vista
  5. Publish again mientras esa copia sigue al frente → solo re-subida (sin segundo duplicado). Activa el máster para preparar una copia nueva o cambiar los ajustes de exportación

El title de la subida usa el nombre del documento; el filename multipart usa {basename}-copy.jpg (p. ej. Tiger-Edit-copy.jpg). Los másters cuyo nombre ya contiene copy reciben un sufijo -copy extra al exportar — es lo esperado.

Solución de problemas

SíntomaComprueba
Connect se queda / denegadoCompleta el consentimiento en /oauth/device; Device Grant habilitado para el cliente OAuth de Photoshop
Lista de portfolios vacíaportfolios:read concedido; el portfolio existe en el mismo espacio de trabajo que el consentimiento; Connect completado
Subida 403Falta media:write o portfolios:write
Tipo de archivo rechazadoMantén el documento activo abierto; la exportación del plugin debe tener éxito
Archivo demasiado grandeActiva Resize o baja la calidad JPEG; aplica el tamaño máximo de imagen de la plataforma
Error de ajustes de exportación cambiadosActiva el máster y publica de nuevo (la copia preparada se creó con otros ajustes)
Subidas duplicadas al reintentarIdempotency-Key estable por documento preparado. Es seguro Publish de nuevo desde la misma copia abierta

Desconectar

Usa Disconnect en el panel o Revocar acceso en Apps conectadas del panel.