Riferimento API

L'API pubblica di PhotoProofing e pensata per integrazioni desktop e workflow di automazione. La versione v1 espone un set minimo di endpoint: elenco e creazione gallery, elenco immagini e upload immagini.

Base URL

https://api.photoproofing.it

Autenticazione

Ogni richiesta protetta deve inviare una API key dell'organizzazione nell'header Authorization:

curl https://api.photoproofing.it/v1/galleries \
  -H "Authorization: Bearer pp_live_your_key_here"

Le API key si generano dall'app nella pagina Admin > Settings.

Rate limiting

Limite: 60 richieste / minuto per API key.
Header: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Se superi il limite, l'API restituisce 429 RATE_LIMIT_EXCEEDED con header Retry-After.

Formato errori

Tutti gli errori usano lo stesso envelope JSON:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key is missing or invalid."
  }
}

Quick start

Creazione gallery:

curl https://api.photoproofing.it/v1/galleries \
  -X POST \
  -H "Authorization: Bearer pp_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Spring Campaign",
    "description": "Sessione tethered da Capture One",
    "status": "proofing"
  }'

Upload immagine su una gallery esistente:

curl https://api.photoproofing.it/v1/galleries/<gallery-id>/images \
  -X POST \
  -H "Authorization: Bearer pp_live_your_key_here" \
  -F "file=@/percorso/assoluto/frame-001.jpg"