Kendi özel iş planınıza Clipping Magic Akıllı Düzenleyicisini entegre etmenin en kolay yolu.
Öncelikle Hızlı Başlangıç bölümünü okuyun.
Sunucu API'si kullanarak bir resim yükleyin.
Bir Barındırılan Akıllı Düzenleyici URL'si oluşturun ve insan olan operatörünüzü sizin tarafınızdan belirlenmiş resimlerde kırpma yapabileceği bu URL'ye yönlendirin.
Tüm resimlerin kırpılmasının ardından, insan olan operatörünüzün tarayıcısı kırpma oturumuna ilişkin alakalı bilgileri içeren bir HTTP POST'uyla belirlenmiş olan İade URL'si'sine gider.
Eğer kırpılan her resim için bir beyaz etiket çözümüne veya geri çağırmaya ihtiyacınız varsa, o zaman lütfen Akıllı Beyaz Etiket Düzenleyicisine bakınız.
https://clippingmagic.com/api/v1/hosted/[apiId]
Basit bir URL oluşturup insan olan operatörünüzün bunu kendi tarayıcısında açarak resimlerinizden bir ya da daha fazlasını gözden geçirmesini ve düzenlemesini sağlayabilirsiniz.
Barındırılan Akıllı Düzenleyici URL'si aşağıdaki parametreleri destekler:
|
images
id1:secret1,id2:secret2,... 123:abc,456:def
Gerekli |
Kırpılacak resimler. |
||||||||||||||||||||||||||||||||||||
|
returnUrl
Dize Gerekli |
İnsan olan operatörünüz kırpma işlemini bitirdiğinde tarayıcıları bu URL'ye bir HTTP POST gönderecektir. Detaylar için aşağıya bakınız. |
||||||||||||||||||||||||||||||||||||
|
useStickySettings
Boole true, false
|
Bu size temel kırpma ayarlarını bir kez yapıp bu ayarları daha sonra düzenlemesini yapacağınız tüm resimlere uygulama imkanı sunmaktadır. Read about how to configure the sticky settings API üzerinden Ön Kırpma özelliği kullanılamıyor ancak Resim Boyutu Limitlerini API yükleme çağrısında ayarlayabilirsiniz.
Varsayılan: |
||||||||||||||||||||||||||||||||||||
|
hideBottomToolbar
Boole true, false
|
Alt araç çubuğunu gizler, bu nedenle editörde bu ayarlar yapılamaz.
Varsayılan: |
||||||||||||||||||||||||||||||||||||
|
locale
Dize |
Düzenleyici için kullanılacak görüntüleme dili. Eğer atlanırsa varsayılan İngilizce dili olacaktır. Geçerli değerler:
|
Modern tarayıcılar çok uzun URL'lere izin verir. Ancak sizin eski tarayıcıları desteklemeniz ve bir oturumda 30 adetten fazla resimde kırpma işlemi yapmanız gerekirse bunları doğrudan bir bağlantı kullanmak yerine bir POST içerisinde girebilirsiniz.
Tek Resim URL Örneği
https://clippingmagic.com/api/v1/hosted/123?images=2346:image_secret1&returnUrl=https%3A%2F%2Fclippingmagic.com%2Fapi%2FreturnUrlExample
Tek bir resmi belirlerken düzenleyicide 'atla' butonu bulunmaz ve kalan resimlerden kırpılması gerekenlerin sayısını göstermez.
Çoklu Resim URL Örneği
https://clippingmagic.com/api/v1/hosted/123?images=2346:image_secret1,2347:image_secret2&returnUrl=https%3A%2F%2Fclippingmagic.com%2Fapi%2FreturnUrlExample
Çoklu resimleri belirlerken düzenleyicide bir 'atla' butonu bulunur ve kalan resimlerden kırpılması gerekenlerin sayısını gösterir.
İnsan olan operatörünüz kırpma işlemini bitirdiğinde tarayıcıları sizin belirlemiş olduğunu İade URL'si'sine bir HTTP POST gönderecektir. BU POST'un gövdesinde tek bir parametre olacaktır: clippingMagicJson. O parametrenin içeriklerini ayrıştırdığınızda hangi resimlerin kırpıldığına dair bilgilerin olduğu bir JSON nesnesi açılır. Bunun ardından İndirme Sunucusu API'sini kullanarak mevcut yeni sonuçları indirebilirsiniz.
|
event
Numaralama editor-exit, error
|
|
||||||
|
images
[{"id":1,"secret":"secret1"},{"id":2,"secret":"secret2"},{"id":3,"secret":"secret3"},{"id":4,"secret":"secret4"}] |
Barındırılan Akıllı Düzenleyici URL'sinde sunulan resimlerin bir dizesi. | ||||||
|
clipped
[{"id":1,"secret":"secret1"},{"id":2,"secret":"secret2"}] |
Bu oturumda kırpılmış olan resimlerin dizisi. Örneğin insan olan operatör tarafından düzenleyicide 'Bitti' olarak işaretlenen resimler. | ||||||
|
skipped
[{"id":3,"secret":"secret3"},{"id":4,"secret":"secret4"}] |
Bu oturumda atlanmış olan resimlerin dizisi. Örneğin insan olan operatör tarafından düzenleyicide 'Atla' işlemi yapılan resimler. | ||||||
|
|
|||||||
POST'un başarılı olması için ya herhangi bir CSRF kontrolünü devre dışı bırakmanız ya da CSRF belirtecini İade URL'si'sine eklemeniz gerekecektir.
Eğer insan olan operatörünüz tarayıcısını kapatırsa veya sizin kullandığınız Barındırılan Akıllı Düzenleyici URL'si ayrıştırılamıyorsa o zaman sizin İade URL'niz çağrılmayacaktır.
clippingMagicJson şuna çözer:
{
"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 şuna çözer:
{
"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"
} ]
}