Come possiamo aiutare?

HomeTecnica

Gli strumenti di integrazione della piattaforma, cosa permettono e quale scegliere in base alle vostre esigenze.

Grand Shooting si inserisce nella vostra catena e-commerce: il vostro PIM o ERP alimenta il Catalogo, gli studi producono i media e i media approvati tornano verso il vostro DAM, il vostro sito o i vostri marketplace. Tutto ciò che fate nell'interfaccia (creare una Produzione, caricare media, approvare, diffondere) è accessibile anche tramite programma.

Quattro strumenti

StrumentoA cosa servePer chi
API RESTLeggere e scrivere i dati dell'account: Referenze, Produzioni, media, Specifiche, stock.Sviluppatori, integratori
Applicazioni OAuthCollegare un software di terzi a un account Grand Shooting senza condividere un token: l'utente autorizza l'applicazione.Editori di software, partner
WebhookEssere avvisati non appena un media o una Referenza viene creato, modificato o eliminato, senza interrogare l'API in continuazione.Sviluppatori, integratori
Server MCPInterrogare Grand Shooting in linguaggio naturale da un assistente IA (Claude…).Utenti business, team di supporto

I cookbook mostrano passo dopo passo le integrazioni più comuni, con esempi curl e Python pronti da copiare.

Quale strumento scegliere?

  • Sincronizzare il Catalogo da un PIM o da un ERP: l'API (POST /reference/bulk), chiamata dal vostro strumento o da un'elaborazione pianificata.
  • Recuperare i media approvati per il vostro DAM o il vostro sito: l'API per il recupero iniziale, poi i webhook pictures/update per elaborare solo ciò che cambia.
  • Caricare foto prodotte altrove (studio esterno, fornitore): l'API di upload, per file o per URL.
  • Proporre il vostro software a tutti i clienti Grand Shooting: un'applicazione OAuth, che ogni account autorizza in pochi clic.
  • Rispondere a domande puntuali ("quanti media sono in attesa di approvazione nella Produzione X?"): il server MCP, senza scrivere codice.

I concetti da conoscere

L'API riprende il vocabolario della piattaforma (vedere il glossario), con alcuni nomi inglesi:

Nell'interfacciaNell'API
Referenza (Catalogo)reference
Media (foto, video, 3D, PDF)picture
Produzioneproduction, identificata da bench_root_id
Fase della Produzione (Live, Post-produzione, Esportazioni / Validazione)bench, con il suo benchsteptype
Specifichespecification (format, category)
Codice di vistaview_type_code
Diffusionebroadcast
Stock (Logistica)stock

Il dettaglio degli oggetti e dei loro stati è in Concetti dell'API.

Il riferimento completo dell'API (tutti gli endpoint, i loro parametri e le loro risposte) è generato a partire dal codice: api.grand-shooting.com. La sua specifica OpenAPI si può scaricare da api.grand-shooting.com/swagger.json: datela al vostro agente di programmazione perché scriva l'integrazione con voi.