Il modo migliore per integrare l'Editor intelligente Clipping Magic nel tuo flusso di lavoro personalizzato.
Leggi prima la guida di Avvio rapido.
Carica un'immagine usando l'API server.
Crea un URL Editor intelligente ospitato e comunicalo al tuo operatore umano, quando ritaglia le immagini che specifichi.
Dopo aver ritagliato tutte le immagini, il browser del tuo operatore umano naviga a URL ritorno specificato con un HTTP POST che contiene le informazioni rilevanti dopo la sessione di ritaglio.
Se hai bisogno di una soluzione di etichetta bianca o un callback per ogni immagine ritagliata, dai un'occhiata a Editor intelligente etichetta bianca.
https://clippingmagic.com/api/v1/hosted/[apiId]
Puoi creare un semplice URL e farlo aprire dal tuo operatore umano nel suo browser in modo che possa esaminare e modificare una o più immagini.
URL Editor intelligente ospitato supporta i seguenti parametri:
images
id1:secret1,id2:secret2,... 123:abc,456:def
Obbligatorio |
Le immagini da ritagliare. Un elenco separato da virgola delle coppie |
||||||||||||||||||||||||||||||||||||
returnUrl
Stringa Obbligatorio |
Quando il tuo operatore umano ha finito di ritagliare, il suo browser rilascia un HTTP POST per questo URL. Vedi i dettagli sotto. |
||||||||||||||||||||||||||||||||||||
useStickySettings
Booleano true , false
|
Se passi a Ciò ti consente di configurare le impostazioni dei ritagli una volta, e quindi applicarli a tutte le immagini che modifichi. Read about how to configure the sticky settings Pre-ritaglio non è disponibile tramite API, ma puoi configurare il limite delle dimensioni dell'immagine nella chiamata di caricamento API.
Predefinito: |
||||||||||||||||||||||||||||||||||||
hideBottomToolbar
Booleano true , false
|
Nasconde la barra inferiore, di conseguenza queste impostazioni non saranno disponibile nell'editor.
Predefinito: |
||||||||||||||||||||||||||||||||||||
locale
Stringa |
La lingua di visualizzazione da usare per l'editor. Se omessa, la lingua è automaticamente l'Inglese. I valori validi sono:
|
I browser moderni consentono URL molto lunghi ma se devi supportare browser legacy e ritagliare più di 30 immagini in una sessione, devi inoltrarle in un POST invece di usare un link diretto.
Esempio di URL di un'immagine singola
https://clippingmagic.com/api/v1/hosted/123?images=2346:image_secret1&returnUrl=https%3A%2F%2Fclippingmagic.com%2Fapi%2FreturnUrlExample
Quando specifichi un'immagine singola l'editor non ha un pulsante 'ignora' e non mostra il numero di immagini da ritagliare rimaste.
Esempio di URL per diverse immagini
https://clippingmagic.com/api/v1/hosted/123?images=2346:image_secret1,2347:image_secret2&returnUrl=https%3A%2F%2Fclippingmagic.com%2Fapi%2FreturnUrlExample
Quando specifichi diverse immagini, l'editor dispone di un pulsante 'ignora' e mostra il numero di immagini da ritagliare rimaste.
Quando il tuo operatore umano ha finito di ritagliare, il suo browser rilascia un HTTP POST a URL ritorno che specifichi. Quel POST conterrà un solo parametro: clippingMagicJson
. Quando analizzi il contenuto di quel parametro, si decomprime in un oggetto JSON con informazioni sulle immagini che sono state ritagliate. Puoi scaricare i risultati ora disponibili usando Scarica API server.
event
Enum editor-exit , error
|
|
||||||
images
[{"id":1,"secret":"secret1"},{"id":2,"secret":"secret2"},{"id":3,"secret":"secret3"},{"id":4,"secret":"secret4"}] |
Un array con le immagini fornite nell'URL Editor intelligente ospitato. | ||||||
clipped
[{"id":1,"secret":"secret1"},{"id":2,"secret":"secret2"}] |
Un array con le immagini effettivamente ritagliate in questa session, vale a dire le immagini per cui l'operatore umano ha cliccato 'Fatto' nell'editor. | ||||||
skipped
[{"id":3,"secret":"secret3"},{"id":4,"secret":"secret4"}] |
Un array con le immagini ignorate in questa sessione, vale a dire le immagini per cui l'operatore umano ha cliccato 'Ignora' nell'editor. | ||||||
Se
|
Devi disabilitare qualsiasi controllo CSRF o aggiungere il token CSRF all' URL ritorno perché il POST riesca.
Se il tuo operatore umano chiude il suo browser o usa un URL Editor intelligente ospitato che non può essere analizzato, l'URL di ritorno non può essere chiamato.
clippingMagicJson
decodifica a:
{ "event" : "editor-exit", "images" : [ { "id" : 2346, "secret" : "image_secret1" }, { "id" : 2347, "secret" : "image_secret2" } ], "clipped" : [ { "id" : 2346, "secret" : "image_secret1" }, { "id" : 2347, "secret" : "image_secret2" } ], "skipped" : [ ] }
clippingMagicJson
decodifica a:
{ "event" : "error", "error" : { "status" : 400, "code" : 1234, "message" : "Example error" }, "images" : [ { "id" : 2346, "secret" : "image_secret1" }, { "id" : 2347, "secret" : "image_secret2" } ], "clipped" : [ ], "skipped" : [ { "id" : 2346, "secret" : "image_secret1" }, { "id" : 2347, "secret" : "image_secret2" } ] }