Human Translation Server API

Sistemimizde bir sipariş oluşturmak için fiyat teklifini aşağıdaki URL üzerinden istek göndererek (GET veya POST) talep edebilirsiniz:

http://www.translated.com/hts/?f=YOUR-REQUIRED-FUNCTION&cid=YOUR-CUSTOMER-ID&p=YOUR-PASSWORD&s=SOURCE-LANGUAGE&t=TARGET-LANGUAGE&text=FILE-NAME&df=FILE-FORMAT&endpoint=http://www.YOUR-DOMAIN

Size bir örnek verelim:

http://www.translated.com/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese&text=blob&df=pdf&endpoint=http://www.your-domain.com/translations/receive

Bu noktada dosyanızı aldık, sistemimize kaydettik ve bir proje olarak başlattık. Dosyanızın tamamı aktarılana kadar talep açık kalıyor; yani internet bağlantınız ne kadar hızlıysa o kadar iyi.

İpucu: Yavaş bir bağlantınız varsa, dosyanızı önceden bir yerlere yükleyip işlem sırasında bize dosya linkini vermeyi düşünebilirsiniz; daha fazla bilgi için İşlev Listesi bölümüne bakınız.

Ayrıca, çevrilmiş dosyanızın teslim edileceği bitim noktasını da belirlemenizi isteyeceğiz. Bir bitim noktası olmadan çevirinin tarafınıza geri gönderilemeyeceğini lütfen unutmayın.

Sistemimiz, dosyanızdan salt metni çıkarır, kelime sayımını yapar (sipariş sırasında w parametresini kullanarak önceden kelime sayısını belirtmemişseniz).
Daha fazla bilgi için İşlev Listesi'ne bakınız.

	Anlamı
1	İstem başarılı
TAMAM	Hata yoksa “OK”, varsa hata mesajı
2013-09-26T15:30:00Z	Zulu saatine (ISO 8601) göre taahhüt edilen teslim tarihi
3082	Tarafımızdan sayılan kelime sayısı
216,99	Hizmet bedeli (Euro olarak)
1040734	Teklif numarası (proje numarası)

Lütfen projenizin henüz başlamadığını, sadece aşağıdaki bilgileri sunduğumuzu unutmayın:

Siparişi onaylamak için onay bildiriminde bulunmanız gerekmektedir.

Teklifi inceledikten ve onayladıktan sonra, proje numarasını belirterek tarafımıza dönüş yapın:

http://www.translated.com/hts/?f=YOUR-REQUIRED-FUNCTION&cid=YOUR-CUSTOMER-ID&p=YOUR-PASSWORD&pid=PROJECT-ID&c=CONFIRMATION-FLAG

Size bir örnek verelim:

http://www.translated.com/hts/?f=confirm&cid=hts-demo&p=hts-demo5&pid=1040734&c=1

Tıpkı önceki işlem gibi burada da GET ve POST yöntemleri iş görecektir. Onay başarılı olursa aşağıdaki yanıtı alırsınız:

	Anlamı
1	İstem başarılı
TAMAM	Hata yoksa “OK”, varsa hata mesajı

Hepsi bu kadar! Proje onaylandı ve dosyalarınız için en uygun çevirmeni seçecek Proje Yöneticilerimizden birine verildi. Bu noktadan sonra size herhangi bir ek e-posta göndermeyeceğiz.

Tercüme edilen dosyayı profesyonelden alındıktan sonra dikkatli bir şekilde gözden geçiririz. Kalite kontrolünden geçmesi durumunda dosya, daha önce üzerinde anlaştığımız, tarafınızdan belirlenen bir HTTP bitim noktasına geri gönderilir (Örneğin: http://www.your-domain.com/translations/receive.php).

Bu son noktada, tarafımızdan veri alabilmek için aşağıdaki parametreleri içeren bir POST kullanılmalıdır:

Birden çok hedef dil için tercüme siparişi verdiyseniz her bir hedef dil için ayrı ayrı istemde bulununuz. Teklif ile arasındaki en büyük fark, teklif işleminde sizin tarafınızdan “pull yönlü” bir fonksiyon işletilirken teslimat işleminde bizim tarafımızdan “push yönlü” bir fonksiyonun işletilmesidir.

İşte bir örnek:

Parametre	Açıklama
Dönüş Kodu	1 teslimat başarılı 0 teslimatta hata oluştu
Hata Mesajı	Hata olmaması durumunda "OK", olması durumunda hata mesajı. Hata mesajı insanların okuyabileceği, oluşan problemin açıklandığı nitelikte olmalıdır.

Kişiselleştirilmiş bir teslimat için lütfen bizimle iletişime geçin: hts@translated.com.

API'miz, gerçek bir sipariş vermeden çeviri talepleri oluşturmanıza ve tarafımıza göndermenize olanak sağlayan, test amaçlı bir sandbox ile birlikte gelir. Sanal alan ortamı, API prosedürünün gerçek bir kesitini temsil eder ve teklifin oluşturulmasından teslimata kadar tüm sürecin işleyişini görmenizi sağlar.

Bir proje onaylanmadan önce tarafınızdan onay (“f=confirm”) alınır, Projenin bir API testi olduğunu belirtmek için “sandbox=1” parametresini kullanmanız yeterli olacaktır, şunun gibi:

http://www.translated.com/hts/?f=confirm&cid=hts-demo&p=hts-demo5&pid=1040734&c=1&sandbox=1

Fiyat teklifi işlevi, test ve üretim işlevleriyle neredeyse aynıdır. Ayrıca, ileteceğimiz mesajdaki metin, çeviri olmayacaktır; fiyat teklifi sırasında bize gönderdiğiniz metnin aynısı olacaktır.

Fiyat teklifinde birden çok kaynak dil olması durumunda, dosya aktarımları arasında 30 saniye ile 2 dakika gibi bir süre geçebilir.

Sanal alan işlevi gerçeği birebir yansıttığı için bu, sizin entegrasyon sırasında tüm döngüyü sınamanızı sağlayacaktır.

Bu işlev, bir insan çevirisi için fiyat ve teslim tarihini gösterir. API'mizi kullanarak insan eliyle yapılacak bir çeviri sipariş etmenin ilk adımı budur.

Geçerli bir yanıt alabilmek için en azından text veya w parametrelerinin girilmesini gerektirir. Bu, sadece kelime sayısını belirterek, belgenizi göndermeden geçerli bir fiyat teklifi alabileceğiniz anlamına gelir.

Bu ll işlevi için aşağıdaki parametreler kullanılır:

Parametre	Açıklama	Varsayılan	Örnek
cid	Kullanıcı adı	/	cid=hts-demo
p	Parola	/	p=hts-demo5
s	Kaynak dil	/	s=English
t	Hedef dil(ler). Birden çok hedef için virgülle ayrılmış değerler	/	t=Italian t=Italian,Spanish,Japanese
text	Çevrilecek içerik. Doğrudan yapıştırılan düz bir metin veya dosyaya ulaşabileceğimiz bir URL olabilir. w parametresinin belirtilmesi isteğe bağlıdır.	/	text=Hello world text="http://www.translated.com/hts/HTS_Tech_Spec.pdf"
pn	Projenin adı	HTS­-NONAME	pn=Translation for tomorrow nr°2
jt	Hizmet Türleri: T-Profesyonel R-Premium P-Ekonomi	T	jt=R
w	Bu dosyaya ait kelime sayısı. Bu parametrenin girilmesi, sunucumuzun eş zamanlı olarak kelime saymaya çalışmasını önlediği gibi işlemin daha hızlı sonlanmasını da sağlar.	/	w=5120
df	Dosya uzantısı anlamında veri formatı. Otomatik kelime sayımı için gereklidir. Otomatik kelime sayımı sadece şunlar için kullanılabilir: 'pdf', 'plaintext','txt', 'xml', 'html', 'htm', 'xliff', 'zip','rtf', 'doc','docx','aea'. Sıkıştırılmış birden fazla dosya göndermek için "zip"i kullanın; içeriğin dosya biçimini otomatik olarak belirleriz.	/	df=zip
tm	Bu proje için kullanmak istediğiniz bir çeviri belleği. Metin parametresi için bir dosya veya URL olabilir. Ayrıca bir MyMemory anahtarı da gönderebileceğinizi unutmayın.	/	tm=823yuc908237 tm=http://www.yousite.net/hts/some_memory.tmx
endpoint	Çeviriyi göndermemizi istediğiniz url. Bağlantınızda özellikle "&" veya diğer özel karakterler bulunuyorsa, ayrıştırma sorunu yaşamamak için URL'nizi kodlamanızı öneririz.	/	endpoint=http://www.mysite.com/path/to/mypage.ext URL­-encoded:endpoint=http%3A%2F%2Fwww.mysite.com%2Fpath%2Fto%2Fmypage.ext
subject	Gönderdiğiniz belgenin konusu. API yöntemlerinin tam listesi için Desteklenen konular listesine bakınız.	Genel	subject=accounting_finance
instructions	Çevirmene iletmek istediğiniz özel talimatlarınız varsa düz yazı biçiminde belirtebilirsiniz.	/	instructions=please leave all lowercase; dates are in US format

Örnek

http://www.translated.com/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese,italian&text=http://www.translated.com/hts/HTS_Tech_Spec.pdf&df=pdf&jt=P&pn=SimpleTest&w=3000

Bu ll işlevi için şu parametrelere yer verilir:

Parametre	Açıklama	Örnek
return code	1 teklif başarılı, 0 teklifte bir hata oluştu	1
error message	Hata olmaması durumunda "OK", olması durumunda hata mesajı	TAMAM
delivery date	Sipariş için garanti edilen teslim tarihini temsil eden tarih ve saat, ISO 8601 standardında: YYYY-AA-GGTSS:dd:SSZ	2013­-02­-18T12:32:00Z
word count	Text parametresinde bizim tarafımızdan sayılan ya da kullanıcı tarafından bildirilen,w" parametresiyle gösterilen kelime sayısı.	456
cost in Euro	Binliklere ayrılmamış, "." ondalık ayırıcısının kullanıldığı bir sayı olarak verilen, siparişinizin Avro cinsinden bedelini gösteren sayı.	223.33
project ID	Siparişi onaylamak istediğinizde kullanacağınız proje numarasıdır	10454289

Bu işlev, önceden talep edilen bir çeviri teklifini onaylar. Bu, HTS kullanılarak insan çevirisi siparişi vermenin ikinci ve son adımıdır.

Bu ll işlevi için aşağıdaki parametreler kullanılır:

Parametre	Açıklama	Varsayılan	Örnek
cid	Kullanıcı adı	/	cid=hts-demo
p	Parola	/	p=hts-demo5
pid	Siparişi onaylamak istediğinizde kullanacağınız proje numarasıdır.	/	pid=10454289
c	Onay işareti. Burada, “onaylama” işlevinde 1 değeri girerek fiyat teklifini kabul eder, 0 girilerek reddedersiniz.	/	c=1 c=0
sandbox	Sandbox (sanal alan) modu. Bu modda, proje test olarak kabul edilir ve tercüme edilecek içerik olduğu gibi teslimat adresine gönderilir. Hiçbir ücret uygulanmaz.	0	sandbox=1
text	Çevrilecek içerik. Şu biçimlerde olabilir: düz metin/binary kodlu metin dosyaya erişilebilen bir URL	/	text=Hello world text=http://www.translated.com/hts/HTS_Tech_Spec.pdf

Örnek

http://www.translated.com/hts/?f=confirm&cid=hts-demo&p=hts-demo5&c=1&pid=232451

Bu ll işlevi için şu parametrelere yer verilir:

Parametre	Açıklama	Örnek
return code	1 teklif başarılı, 0 teklifte bir hata oluştu	1
error message	Hata olmaması durumunda "OK", olması durumunda hata mesajı	TAMAM

Bu işlev, gönderdiğiniz tüm projelerin durumunu izlemenizi sağlar.

Bu ll işlevi için aşağıdaki parametreler kullanılır:

Parametre	Açıklama	Varsayılan	Örnek
cid	Kullanıcı adı	/	cid=hts-demo
p	Parola	/	p=hts-demo5
pid	Siparişi onaylamak istediğinizde kullanacağınız proje numarasıdır.	/	pid=10454289

Örnek

http://www.translated.com/hts/?f=status&cid=hts-demo&p=hts-demo5&c=1&pid=232451

Bu ll işlevi için şu parametrelere yer verilir:

Parametre	Açıklama	Örnek
return code	1 teklif başarılı, 0 teklifte bir hata oluştu	1
error message	Hata olmaması durumunda "OK", olması durumunda hata mesajı	TAMAM
list of jobs belonging to the project, one per line, with semicolon separated values	bir iş hattı şunlardan oluşur: numara;iş_türü;kaynak;hedef;kelime;müşteri_toplam;sipariş_tarihi;teslimat_tarihi;py;py_e-postası	one line job: 9687796;REVISION;Italian;English;182;10.00;IN PROCESS;2012­-11­-29 T15:35:00Z;2013­-01-­25 T16:00:00Z;GIANFRANCO;gianfranco@translated.com

Bu işlev, insan çevirisi için desteklenen dil kodlarının listesini gösterir (teklif ve onaylama işlevlerinin kaynak ve hedef parametreleri için). Liste RFC 3066 kodunu, ISO iki ve üç harfli kodları içerir.

Bu işlev, sisteminizde desteklenen dil listesini düzenli olarak güncellemek için kullanılmalıdır.

Bu ll işlevi için aşağıdaki parametreler kullanılır:

Parametre	Açıklama	Varsayılan	Örnek
cid	Kullanıcı adı	/	cid=hts-demo
p	Parola	/	p=hts-demo5

Örnek

http://www.translated.com/hts/?f=ll&cid=hts-demo&p=hts-demo5

Bu ll işlevi için şu parametrelere yer verilir:

Parametre	Açıklama	Örnek
return code	1 teklif başarılı, 0 teklifte bir hata oluştu	1
list of languages	bir dil hattı şunlardan oluşur: dil adı;RFC3066 kodu;ISO 639­1 kodu;ISO 639­2 kodu	Amharic;am­AM;am;amh

Bu işlev, insan çevirisi için desteklenen konu kodlarının listesini gösterir. Bu işlev, sisteminizde desteklenen konu listesini düzenli olarak güncellemek için kullanılmalıdır.

Bu ll işlevi için aşağıdaki parametreler kullanılır:

Parametre	Açıklama	Varsayılan	Örnek
cid	Kullanıcı adı	/	cid=hts-demo
p	Parola	/	p=hts-demo5

Örnek

http://www.translated.com/hts/?f=ll&cid=hts-demo&p=hts-demo5

Bu ll işlevi için şu parametrelere yer verilir:

Parametre	Açıklama	Örnek
return code	1 teklif başarılı, 0 teklifte bir hata oluştu	1
list of subjects	Çevirisini yaptırmak istediğiniz belgenin konusu	accounting_finance aerospace_defence architecture

Bir teklifin geçerlilik süresi 24 saattir.

API, sipariş oluşturma ve dosyaları doğrudan sunucularımıza aktarma amaçlı bir sistem olduğundan, her türlü dosyayı destekliyoruz. Yine de otomatik sözcük sayımı gibi ileri düzey özellikler sadece şunlar için kullanılabilir: pdf, txt, xml, html, xliff, rtf, doc, docx, aea. Diğer dosya türlerinde kelime sayımı sizin tarafınızdan eksiksiz bir şekilde yapılmalı ve ilgili parametreler kullanılarak tarafımıza bildirilmelidir ( İşlev Listesi'nde verilen Fiyat Teklifi işlevine bakınız ).

Belgeler, tarafınızdan belirlenen bir hedefe HTTP POST yoluyla teslim edilir. Lütfen bize bu bilgileri göndermeyi unutmayınız. Aksi durumda çevirilerinizi tarafınıza gönderemeyiz.

Her bir proje için 5 gün içerisinde ödenmek üzere birer fatura göndereceğiz. Yüksek hacimli veya düzenli kullanım için aylık ödemeler ayarlayabiliriz.

Evet, fiyatlarımızda dalgalanma olmaz. Metnin dosyadan çıkarılması için işe ne kadar çok mühendislik katarsak çevirinin tesliminin de bir o kadar gecikecğini lütfen unutmayın.

Sistem, dosyanızı ayrıştırıp, saf metni ve sayılabilir sözcükleri ayıklayarak sözcük sayımını otomatik hale getirir. Word formatları gibi daha zengin dosya biçimleri, süreç içerisinde ayıklanan ek meta verileri de (dosya yorumları, yazar bilgileri vb.) içerebilmektedir. Bu, sözcük sayımında küçük oynamalara neden olabilir. Translated, çeviriye başlanmadan önce kelime sayımında önemli bir tutarsızlığının bulunup bulunmadığından emin olmak için Proje Yöneticilerine her bir dosyanın ayrıntılı incelemesini yaptırır.

Evet. API'miz tüm dosya türlerini destekler; desteklenen veri formatları çevrimiçi otomatik kelime sayımı içindir.

O halde lütfen hts@translated.com adresinden bizimle iletişime geçin. Bu hususu görüşmekten memnuniyet duyarız.

Aşağıdaki örnekte verdiğimiz gibi “t” parametresinde değerlerin arasına virgül kullanarak gönderebilirsiniz:

http://www.translated.com/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese,italian,spanish&text=blob&df=pdf&endpoint=http://www.your-domain.com/translations/receive

Aşağıdaki örnekte verdiğimiz gibi “w” kelime sayım parametresini “text” bölümünde kullanabilirsiniz:

http://www.translated.com/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=english&t=japanese&w=1000&df=pdf&endpoint=http://www.your-domain.com/translations/receive

Varsayılan olarak API'miz saf metin olarak çıktılar üretir; ancak “of=json” olarak belirttiğiniz takdirde JSON olarak çıktı üretecektir. Bu isteğe bağlı parametre diğer tüm API işlevleri için de geçerlidir (“fiyat teklifi”, “onaylama”, “durum”, “ll”, “konu”).

API'miz, gerçek bir sipariş vermeden tüm teklif, onay, teslimat döngüsünü kontrol edebileceğiniz bir sanal alan (sandbox) sunar. Sandbox projeleri için herhangi bir ücret talep edilmez ve bir kullanıcının uygulayabileceği sandbox projelerinin sayısı konusunda bir sınırlama bulunmamaktadır. İlgili bölümde detaylı bir açıklama bulabilirsiniz.