Übersicht
Ermöglicht Drittanbieter-Tools, im Namen eines Fotografen in Portfolios zu veröffentlichen und Medien aus der Bibliothek zu lesen – OAuth, PAT und `/api/v1` für Lightroom, Capture One, Photoshop und individuelle Integratoren.
Die Entwickler-API von ArtInStack ermöglicht es Drittanbieter-Tools, im Namen eines Fotografen zu handeln – Bilder in Portfolios zu veröffentlichen und Medien aus der Bibliothek zu lesen –, ohne die Dashboard-Oberfläche zu verwenden. Sie bildet die Grundlage für den offiziellen Lightroom Classic Publish Service, das Capture One Publish Plugin und das Photoshop UXP Plugin. Fotografen können dadurch direkt aus ihrem Editor in ein Portfolio exportieren, mit wiederholungssicheren Uploads und ohne Dateien manuell erneut hochladen zu müssen. Derselbe OAuth-/PAT-Vertrag steht weiteren Integratoren offen, die auf den Medien und Portfolios eines Arbeitsbereichs aufbauen möchten.
Dies ist der mandantenbezogene HTTP-Vertrag für diese Clients. Er ist nicht die anonyme Storefront-API (/api/public/…) und nicht die Dashboard-API mit Cookie-Sitzung (/api/…, die von der angemeldeten Benutzeroberfläche verwendet wird).
Basis-URL
| Umgebung | API-Host |
|---|---|
| Produktion | https://app.artinstack.com |
Ressourcenpfade befinden sich unter /api/v1/. Die OAuth-Protokollendpunkte befinden sich unter /oauth/authorize (Seite) sowie /api/oauth/token und /api/oauth/revoke. Der Device Authorization Grant verwendet /api/oauth/device_authorization und /oauth/device.
Anmeldedaten
| Modell | Verwenden, wenn |
|---|---|
| OAuth 2.0 + PKCE | Desktop-Apps, die eine Loopback-Weiterleitung binden können (Lightroom, Capture One, Partner-Apps) |
| OAuth 2.0 Device Code | Hosts, die nicht auf localhost lauschen können (Photoshop UXP) |
| Persönliches Zugriffstoken (PAT) | Skripte, CI, Kamerafallen-Pipelines und Automatisierungen, bei denen OAuth unpraktisch ist |
Beide werden durch dieselbe Bearer-Middleware unter /api/v1/* verarbeitet. Siehe Authentifizierung.
v1-Ressourcen
Die private Beta konzentriert sich auf den Desktop-Veröffentlichungsablauf (Lightroom Classic, Capture One und Photoshop):
- Medien: Bilder hochladen
- Portfolios: Ziele auflisten und Medien zuordnen
Ressourcen für den Naturschutz (observations, surveys, deployments) folgen in einer späteren API-Phase.
API-Referenz
Endpunkte, Authentifizierung sowie Anfrage- und Antwortformate finden Sie in der interaktiven API-Referenz.
Offizielle Clients
Laden Sie offizielle Binärdateien unter Software herunter. Einrichtungsanleitungen: Lightroom Classic, Capture One, Photoshop.
Nächste Schritte
- OAuth 2.0 – einen öffentlichen Client mit PKCE oder Device Code autorisieren
- Berechtigungsbereiche – erforderliche Fähigkeiten
- Medien und Portfolios – hochladen und veröffentlichen
