Descripción general
Permite que herramientas de terceros publiquen en portfolios y lean medios de la biblioteca en nombre de un fotógrafo: OAuth, PAT y `/api/v1` para Lightroom, Capture One, Photoshop e integradores personalizados.
La API para desarrolladores de ArtInStack permite que herramientas de terceros actúen en nombre de un fotógrafo — publicar imágenes en portfolios, leer medios de la biblioteca — sin pasar por la interfaz del panel. Así funcionan el servicio de publicación oficial de Lightroom Classic, el plugin de publicación de Capture One y el plugin UXP de Photoshop, para que los fotógrafos exporten directamente desde su editor a un portfolio, con subidas seguras ante reintentos y sin volver a subir a mano. El mismo contrato OAuth/PAT está abierto a otros integradores que quieran construir sobre los medios y portfolios de un espacio de trabajo.
Este es el contrato HTTP con ámbito de inquilino (tenant) para esos clientes. No es la API anónima de escaparate (/api/public/…) ni la API de sesión por cookie del panel (/api/… usada por la UI con sesión iniciada).
URL base
| Entorno | Host de la API |
|---|---|
| Producción | https://app.artinstack.com |
Las rutas de recursos están bajo /api/v1/. Los endpoints del protocolo OAuth están bajo /oauth/authorize (página) y /api/oauth/token, /api/oauth/revoke. Device Authorization Grant usa /api/oauth/device_authorization y /oauth/device.
Credenciales
| Modelo | Úsalo cuando |
|---|---|
| OAuth 2.0 + PKCE | Apps de escritorio que pueden enlazar un redirect en loopback (Lightroom, Capture One, apps de partners) |
| OAuth 2.0 Device Code | Hosts que no pueden escuchar en localhost (Photoshop UXP) |
| Token de acceso personal (PAT) | Scripts, CI, pipelines de camera-trap, automatización donde OAuth no es práctico |
Ambos se resuelven con un único middleware Bearer en /api/v1/*. Ver Autenticación.
Recursos v1
La beta privada se centra en la ruta de publicación de escritorio (Lightroom Classic, Capture One y Photoshop):
- Medios: subir imágenes
- Portfolios: listar destinos y adjuntar medios
Los recursos de conservación (observations, surveys, deployments) llegan en una fase posterior de la API.
Referencia de la API
Explora endpoints, autenticación y formas de petición/respuesta en la referencia interactiva de la API.
Clientes oficiales
Descarga los binarios oficiales en Software. Guías de configuración: Lightroom Classic, Capture One, Photoshop.
Siguientes pasos
- OAuth 2.0 — autorizar un cliente público con PKCE o Device Code
- Ámbitos (scopes) — capacidades requeridas
- Medios y Portfolios — subir y publicar