Capture One

Ceci est le guide d'intégration du plugin de publication officiel Capture One. Référence API : OAuth, Médias, Portfolios.

Prérequis

• Capture One Pro 12+
• Compte ArtInStack avec au moins un portfolio créé dans le tableau de bord
• Zip plateforme depuis Software (macOS et Windows sont des téléchargements séparés)

Installation

macOS

1. Téléchargez Download for macOS depuis Software
2. Décompressez. Vous devez obtenir ArtInStackCaptureOne.coplugin
3. Double-cliquez le .coplugin, ou copiez-le vers ~/Library/Application Support/Capture One/Plug-ins/
4. Capture One → Preferences → Plugins → activez ArtInStack

Windows

1. Téléchargez Download for Windows depuis Software
2. Décompressez. Vous devez obtenir ArtInStackCaptureOne.coplugin
3. Capture One → Preferences → Plugins → + → sélectionnez le paquet .coplugin
4. Activez ArtInStack

Connexion (OAuth PKCE)

1. Preferences → Plugins → ArtInStack
2. Cliquez sur Connect…. Le navigateur ouvre /oauth/authorize
3. Connectez-vous si besoin, puis approuvez les portées
4. Le navigateur redirige vers le loopback (http://127.0.0.1:54322/callback) ; le plugin stocke access + refresh tokens
5. Applications connectées dans Paramètres → Développeur liste ArtInStack Capture One après consentement

Choisir un portfolio

1. Sélectionnez des variantes → Publish → Publish to ArtInStack
2. Destination → Portfolio charge GET /api/v1/portfolios
3. Choisissez le portfolio (les confidentiels sont étiquetés)
4. Créez les portfolios dans le tableau de bord ArtInStack. Le plugin ne les crée pas

Publier

1. Confirmez la sélection du portfolio
2. Lancez la publication. Capture One rend pour le téléversement (le plugin téléverse du JPEG aujourd'hui ; grand côté 2048 par défaut dans les réglages de traitement)
3. Le plugin téléverse via POST /api/v1/media avec Idempotency-Key et portfolio_id
4. En cas de succès, la photo apparaît dans le portfolio du tableau de bord ; le plugin stocke le media_id distant

Les types API pris en charge (JPEG, PNG, GIF, WebP, TIFF) sont listés sur Médias.

Dépannage

Symptôme	Vérifier
Échec de Connect	Loopback http://127.0.0.1:54322/callback enregistré sur le client OAuth Capture One ; pare-feu bloquant localhost
Liste de portfolios vide	portfolios:read accordé ; le portfolio existe dans le même espace de travail que le consentement ; Connect terminé
Téléversement 403	media:write ou portfolios:write manquant
Fichier trop volumineux	Exportez une image plus petite ; la taille max plateforme s'applique
Doublons au nouvel essai	Idempotency-Key stable par contenu de fichier. Sûr de Publish à nouveau

Déconnexion

Utilisez Disconnect dans Plugin Manager ou Révoquer l'accès sous Applications connectées dans le tableau de bord.