Capture One

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

Requisitos previos

• Capture One Pro 12+
• Cuenta de ArtInStack con al menos un portfolio creado en el panel
• Zip de la plataforma desde Software (macOS y Windows son descargas separadas)

Instalación

macOS

1. Descarga Download for macOS desde Software
2. Descomprime. Debes obtener ArtInStackCaptureOne.coplugin
3. Haz doble clic en el .coplugin, o cópialo a ~/Library/Application Support/Capture One/Plug-ins/
4. Capture One → Preferences → Plugins → activa ArtInStack

Windows

1. Descarga Download for Windows desde Software
2. Descomprime. Debes obtener ArtInStackCaptureOne.coplugin
3. Capture One → Preferences → Plugins → + → selecciona el paquete .coplugin
4. Activa ArtInStack

Conectar (OAuth PKCE)

1. Preferences → Plugins → ArtInStack
2. Haz clic en Connect…. El navegador abre /oauth/authorize
3. Inicia sesión si se te pide y aprueba los ámbitos
4. El navegador redirige al loopback (http://127.0.0.1:54322/callback); el plugin guarda access + refresh tokens
5. Apps conectadas en Ajustes → Desarrollador lista ArtInStack Capture One tras el consentimiento

Elegir un portfolio

1. Selecciona variantes → Publish → Publish to ArtInStack
2. Destination → Portfolio carga GET /api/v1/portfolios
3. Elige el portfolio (los confidenciales están etiquetados)
4. Crea portfolios en el panel de ArtInStack. El plugin no los crea

Publicar

1. Confirma la selección de portfolio
2. Ejecuta la publicación. Capture One renderiza para la subida (el plugin sube JPEG hoy; lado largo 2048 por defecto en los ajustes de procesamiento)
3. El plugin 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 plugin guarda el media_id remoto

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

Solución de problemas

Síntoma	Comprueba
Fallo al conectar	Loopback http://127.0.0.1:54322/callback registrado en el cliente OAuth de Capture One; firewall bloqueando localhost
Lista de portfolios vacía	portfolios:read concedido; el portfolio existe en el mismo espacio de trabajo que el consentimiento; Connect completado
Subida 403	Falta media:write o portfolios:write
Archivo demasiado grande	Exporta una imagen más pequeña; aplica el tamaño máximo de imagen de la plataforma
Subidas duplicadas al reintentar	Idempotency-Key estable por contenido de archivo. Es seguro Publish de nuevo

Desconectar

Usa Disconnect en Plugin Manager o Revocar acceso en Apps conectadas del panel.