Capture One

Dies ist die Integrationsanleitung für das offizielle Capture One Publish Plugin. API-Referenz: OAuth, Medien, Portfolios.

Voraussetzungen

• Capture One Pro 12+
• ArtInStack-Konto mit mindestens einem im Dashboard erstellten Portfolio
• Plattform-ZIP von Software (macOS und Windows sind separate Downloads)

Installation

macOS

1. Laden Sie Download for macOS unter Software herunter
2. Entpacken Sie die Datei. Sie sollten ArtInStackCaptureOne.coplugin erhalten
3. Doppelklicken Sie auf die .coplugin-Datei oder kopieren Sie sie nach ~/Library/Application Support/Capture One/Plug-ins/
4. Capture One → Preferences → Plugins → ArtInStack aktivieren

Windows

1. Laden Sie Download for Windows unter Software herunter
2. Entpacken Sie die Datei. Sie sollten ArtInStackCaptureOne.coplugin erhalten
3. Capture One → Preferences → Plugins → + → das .coplugin-Paket auswählen
4. Aktivieren Sie ArtInStack

Verbinden (OAuth PKCE)

1. Preferences → Plugins → ArtInStack
2. Klicken Sie auf Connect…. Der Browser öffnet /oauth/authorize
3. Melden Sie sich bei Aufforderung an und genehmigen Sie die Berechtigungsbereiche
4. Der Browser leitet zum Loopback weiter (http://127.0.0.1:54322/callback); das Plugin speichert Zugriffs- und Aktualisierungstoken
5. Nach der Einwilligung wird ArtInStack Capture One unter Connected apps in Einstellungen → Entwickler aufgeführt

Portfolio auswählen

1. Varianten auswählen → Publish → Publish to ArtInStack
2. Destination → Portfolio lädt GET /api/v1/portfolios
3. Wählen Sie das Portfolio (vertrauliche Portfolios sind gekennzeichnet)
4. Erstellen Sie Portfolios im ArtInStack-Dashboard. Das Plugin erstellt sie nicht

Veröffentlichen

1. Bestätigen Sie die Portfolio-Auswahl
2. Starten Sie die Veröffentlichung. Capture One rendert für den Upload (das Plugin lädt derzeit JPEG hoch; in den Verarbeitungseinstellungen ist standardmäßig eine lange Kante von 2048 eingestellt)
3. Das Plugin lädt über POST /api/v1/media mit Idempotency-Key und portfolio_id hoch
4. Bei Erfolg erscheint das Foto im Dashboard-Portfolio; das Plugin speichert die entfernte media_id

Die unterstützten API-Typen (JPEG, PNG, GIF, WebP, TIFF) sind unter Medien aufgeführt.

Fehlerbehebung

Symptom	Prüfen
Connect schlägt fehl	Loopback http://127.0.0.1:54322/callback im OAuth-Client von Capture One registriert; Firewall blockiert localhost
Leere Portfolio-Liste	portfolios:read gewährt; Portfolio befindet sich im selben Arbeitsbereich wie die Einwilligung; Connect abgeschlossen
Upload 403	media:write oder portfolios:write fehlt
Datei zu groß	Kleineres Bild exportieren; die maximale Bildgröße der Plattform gilt
Doppelte Uploads bei Wiederholung	Stabiler Idempotency-Key pro Dateiinhalt. Erneutes Publish ist sicher

Verbindung trennen

Verwenden Sie Disconnect im Plugin Manager oder Revoke access unter Connected apps im Dashboard.