Présentation
Permettez à des outils tiers de publier dans les portfolios et de lire les médias de la bibliothèque pour le compte d'un photographe — OAuth, PAT et `/api/v1` pour Lightroom, Capture One, Photoshop et les intégrateurs personnalisés.
L'API développeur de ArtInStack permet à des outils tiers d'agir pour le compte d'un photographe — publier des images dans des portfolios, lire les médias de la bibliothèque — sans passer par l'interface du tableau de bord. C'est ce qui alimente le service de publication officiel Lightroom Classic, le plugin de publication Capture One et le plugin UXP Photoshop, afin que les photographes exportent directement depuis leur éditeur vers un portfolio, avec des envois sûrs en cas de nouvelle tentative et sans rechargement manuel. Le même contrat OAuth/PAT est ouvert aux autres intégrateurs qui souhaitent s'appuyer sur les médias et portfolios d'un espace de travail.
Il s'agit du contrat HTTP limité au locataire (tenant) pour ces clients. Ce n'est pas l'API anonyme de vitrine (/api/public/…) ni l'API de session par cookie du tableau de bord (/api/… utilisée par l'UI connectée).
URL de base
| Environnement | Hôte de l'API |
|---|---|
| Production | https://app.artinstack.com |
Les chemins de ressources sont sous /api/v1/. Les endpoints du protocole OAuth sont sous /oauth/authorize (page) et /api/oauth/token, /api/oauth/revoke. Device Authorization Grant utilise /api/oauth/device_authorization et /oauth/device.
Identifiants
| Modèle | À utiliser quand |
|---|---|
| OAuth 2.0 + PKCE | Applications de bureau pouvant lier une redirection en loopback (Lightroom, Capture One, apps partenaires) |
| OAuth 2.0 Device Code | Hôtes qui ne peuvent pas écouter sur localhost (Photoshop UXP) |
| Jeton d'accès personnel (PAT) | Scripts, CI, pipelines camera-trap, automatisation où OAuth n'est pas pratique |
Les deux passent par un seul middleware Bearer sur /api/v1/*. Voir Authentification.
Ressources v1
La bêta privée se concentre sur le parcours de publication bureau (Lightroom Classic, Capture One et Photoshop) :
- Médias : téléverser des images
- Portfolios : lister les destinations et rattacher des médias
Les ressources de conservation (observations, surveys, deployments) arriveront dans une phase API ultérieure.
Référence de l'API
Parcourez les endpoints, l'auth et les formes requête/réponse dans la référence interactive de l'API.
Clients officiels
Téléchargez les binaires officiels depuis Software. Guides d'installation : Lightroom Classic, Capture One, Photoshop.
Étapes suivantes
- OAuth 2.0 — autoriser un client public avec PKCE ou Device Code
- Portées (scopes) — capacités requises
- Médias et Portfolios — téléverser et publier