API pentru Human Translation Server

Tu soliciți o estimare de preț pentru a plasa o comandă în sistemul nostru prin emiterea unei solicitări (GET sau POST) la următoarea adresă URL:

https://www.translated.net/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

Iată un exemplu:

https://www.translated.net/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

La acest moment, am preluat deja fișierul, l-am stocat în sistemele noastre și am inițializat un proiect. Această solicitare este de fapt suspendată până când preluăm întregul fișier. Cu cât este mai rapid linkul tău de internet, cu atât mai bine.

Sugestie: dacă ai un link de internet lent, ia în considerare să încarci fișierul în prealabil undeva și apoi să ne transmiți adresa URL către acel fișier în parametrul text; consultă Lista de funcții pentru mai multe detalii.

De asemenea, îți solicităm să specifici punctul final la care va fi livrat fișierul tău tradus. Te rugăm să reții că, fără un punct final, nu îți vom putea returna traducerea.

Sistemul nostru extrage textul pur din documentul tău și numără cuvintele (dacă nu ai furnizat în mod explicit numărul în cerere), prin intermediul parametrului w.
Consultă Lista de funcții pentru detalii suplimentare și apoi emite o estimare de preț, care cuprinde:

	Semnificație
1	Solicitarea a reușit
OK	„OK” sau un mesaj de eroare, dacă a intervenit o eroare
2013-09-26T15:30:00Z	Data de livrare garantată în ora Zulu (ISO 8601)
3082	Numărul de cuvinte numărat de noi
216,99	Prețul este exprimat în euro
1040734	ID pentru această estimare de preț (ID proiect)

Te rugăm să reții că traducerea proiectului tău nu a început încă. Îți oferim doar următoarele informații:

Pentru a confirma comanda, trebuie să emiți o solicitare de confirmare

După ce ai examinat și aprobat estimarea de preț, trebuie să o confirmi trimițând înapoi următoarele date:

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

Iată un exemplu:

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

Ca și înainte, ambele metode GET sau POST funcționează la fel de bine. Dacă confirmarea este reușită, te poți aștepta la următorul răspuns:

	Semnificație
1	Solicitarea a reușit
OK	„OK” sau un mesaj de eroare, dacă a intervenit o eroare

Asta e tot! Proiectul a fost confirmat și a fost înmânat unuia dintre managerii noștri de proiect, care va avea grijă să selecteze cel mai potrivit traducător pentru fișierul tău. Din acest moment, totul decurge lin.

După ce primim fișierul tradus de la profesionist, îl examinăm cu atenție. Dacă trece de verificarea calității, fișierul este trimis înapoi la un punct final HTTP din partea ta, pe care l-ai convenit cu noi anterior (de ex.: http://www.your-domain.com/translations/receive.php).

Acest punct final ar trebui să aștepte în orice moment o solicitare POST de la noi, cu următoarele câmpuri:

Dacă ai comandat mai multe limbi țintă, așteaptă-te la o solicitare separată pentru fiecare limbă țintă. Principala diferență între acest proces și o estimare de preț este aceea că estimarea este o funcție de tip „pull” activată de tine, în timp ce livrarea este o funcție de tip „push” declanșată de noi.

Iată un exemplu PHP:

Parametru	Descriere
Cod retur	1 dacă livrarea a reușit 0 dacă a intervenit o eroare
Mesaj de eroare	„OK” dacă nu a intervenit nicio eroare sau mesajul de eroare în caz contrar. Mesajul de eroare ar trebui să fie ușor de înțeles și să explice ce a nu mers bine.

Pentru un flux de lucru de apelare inversă personalizat, te rugăm să ne contactezi la adresa hts@translated.com.

HTS e echipat cu un mediu de tip sandbox în scopuri de testare, care ne permite să generăm și să trimitem solicitări de traducere fără a crea de fapt o comandă reală. Mediul sandbox reprezintă o abstractizare exactă a procedurii API și face posibilă vizualizarea întregului proces în acțiune, de la estimarea de preț până la livrare.

Atunci când confirmi un proiect pentru care ai solicitat anterior o estimare de preț („f=confirm”), tot ce trebuie să faci este să adaugi parametrul „sandbox=1” pentru a confirma faptul că acel proiect este un test API, după cum urmează:

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

Te rugăm să reții faptul că funcția de estimare de preț este identică atât pentru testare, cât și pentru producție. Mai mult, textul mesajului livrat nu va fi traducerea, ci același text pe care ni l-ai trimis cu estimarea de preț, întrucât singurul scop este acela de a crea un test de proiect de traducere prin API.

Dacă în estimarea de preț există mai multe limbi țintă, așteaptă-te la livrări multiple într-o perioadă de timp aleatorie, care variază între 30 de secunde și 2 minute.

Sandbox acționează exact la fel ca procesul real și îți permite să testezi întreaga buclă pentru integrarea ta.

Această funcție returnează prețul și data de livrare pentru o traducere umană. Acesta este primul pas în comandarea unei traduceri umane utilizând HTS.

Funcția necesită cel puțin textul sau parametrul w pentru a returna un răspuns valid. Acest lucru înseamnă că poți obține o estimare de preț valabilă fără să trimiți efectiv documentul tău, dacă specifici cel puțin numărul de cuvinte.

Funcția estimare de preț acceptă următorii parametri:

Parametru	Descriere	Implicit	Exemplu
cid	Nume utilizator	/	cid=hts-demo
p	Parolă	/	p=hts-demo5
s	Limba sursă	/	s=engleză
t	Limba (limbile) țintă. Valori separate prin virgule pentru mai multe limbi țintă	/	t=italiană t=italiană,spaniolă,japoneză
text	Conținutul care trebuie tradus. Poate fi un text simplu în line sau o adresă URL către fișier. Te rugăm să reții că acesta este opțional dacă parametrul w a fost specificat.	/	text=Hello world text="https://www.translated.net/hts/HTS_Tech_Spec.pdf"
pn	Numele proiectului	HTS-NONAME	pn=traducere pentru mâine nr. 2
jt	Tipuri de lucrări: T pentru Professional R pentru Premium P pentru Economy	T	jt=R
w	Numărul de cuvinte pentru acest fișier. Acest parametru permite serverului nostru să evite calcularea numărului de cuvinte al fișierului în timp real, ceea ce are drept rezultat răspunsuri mai rapide.	/	w=5120
df	Formatul de date, ca extensie a fișierului. Necesar pentru numărarea automată a cuvintelor. Numărarea automată a cuvintelor este disponibilă numai pentru: „pdf”, „text simplu”, „txt”, „xml”, „html”, „htm”, „xliff”, „zip”, „rtf”, „doc”, „docx “, „aea”. Specifică „zip” pentru a trimite mai multe fișiere arhivate, iar noi vom ghici automat formatul de fișier al conținutului.	/	df=zip
tm	O memorie de traducere pe care dorești să o utilizezi pentru acest proiect. Parametrul text poate fi un fișier sau o adresă URL. Reține că poți trece și o cheie MyMemory.	/	tm=823yuc908237 tm=http://www.yousite.net/hts/some_memory.tmx
punct final	Adresa URL la care dorești să trimitem traducerea. Îți sugerăm codarea URL-ului punctului tău final pentru a evita problemele de analiză, în special dacă linkul tău conține „&” sau alte caractere speciale.	/	endpoint=http://www.mysite.com/path/to/mypage.ext URL­-encoded:endpoint=http%3A%2F%2Fwww.mysite.com%2Fpath%2Fto%2Fmypage.ext
subiect	Subiectul documentului pe care îl trimiți. Consultă Lista de subiecte acceptate metodă API pentru o listă completă.	general	subject=accounting_finance
instrucțiuni	Specifică un set de instrucțiuni pentru traducător, în text simplu	/	instrucțiuni= te rugăm să utilizezi numai minuscule; datele sunt în format SUA

Exemplu

https://www.translated.net/hts/?f=citat& Cid =hts-demo& P =hts-demo5& S =Engleză& T =japoneză, italiană& = text,https://www.translated.net/hts/HTS_Tech_Spec.pdf& Df =pdf& Jt =P& PN =SimpleTest& W =3000

Funcția estimare de preț returnează următoarele câmpuri:

Parametru	Descriere	Exemplu
cod returnat	1 dacă estimarea de preț a reușit, 0 dacă a intervenit o eroare	1
mesaj de eroare	„OK” dacă nu a intervenit nicio eroare sau mesajul de eroare în caz contrar	OK
data livrării	Data și ora care reprezintă termenul garantat pentru comandă, în standardul ISO 8601: AAAA-LL­-ZZTHH:mm:SSZ	2013­-02­-18T12:32:00Z
număr de cuvinte	Număr de cuvinte specificat în parametrul text, fie numărat de noi sau trimis de utilizator prin intermediul parametrului „w”	456
cost în euro	Cost în euro al comenzii, formatat ca număr fără separatoare de mii și „,” ca separator zecimal	223.33
ID proiect	ID-ul proiectului pe care trebuie să îl utilizezi atunci când dorești să confirmi această comandă	10454289

Această funcție confirmă o estimare de preț de traducere umană solicitată anterior. Acesta este al doilea și ultimul pas în plasarea unei comenzi de traducere umană utilizând HTS.

Funcția confirm acceptă următorii parametri:

Parametru	Descriere	Implicit	Exemplu
cid	Nume utilizator	/	cid=hts-demo
p	Parolă	/	p=hts-demo5
pid	ID-ul proiectului pe care trebuie să îl utilizezi atunci când dorești să confirmi această comandă.	/	pid=10454289
c	Marcajul confirmare. Poți confirma o estimare de preț în cadrul funcției „confirm”, alocând valoarea 1 acestui parametru și refuza o estimare de preț, alocând valoarea 0.	/	c=1 c=0
sandbox	Modul Sandbox. În acest mod, proiectul este considerat un test și conținutul de tradus este trimis la punctul final neschimbat. Nu sunt percepute taxe.	0	sandbox=1
text	Conținutul care trebuie tradus. Poate fi: un text simplu în linie/blob binar o adresă URL către fișier	/	text=Hello world text=https://www.translated.net/hts/HTS_Tech_Spec.pdf

Exemplu

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

Funcția confirm returnează următoarele câmpuri:

Parametru	Descriere	Exemplu
cod returnat	1 dacă estimarea de preț a reușit, 0 dacă a intervenit o eroare	1
mesaj de eroare	„OK” dacă nu a intervenit nicio eroare sau mesajul de eroare în caz contrar	OK

Această funcție îți permite să urmărești starea tuturor proiectelor pe care le-ai trimis.

Funcția status acceptă următorii parametri:

Parametru	Descriere	Implicit	Exemplu
cid	Nume utilizator	/	cid=hts-demo
p	Parolă	/	p=hts-demo5
pid	ID-ul proiectului pe care trebuie să îl utilizezi atunci când dorești să confirmi această comandă.	/	pid=10454289

Exemplu

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

Funcția status returnează următoarele câmpuri:

Parametru	Descriere	Exemplu
cod returnat	1 dacă estimarea de preț a reușit, 0 dacă a intervenit o eroare	1
mesaj de eroare	„OK” dacă nu a intervenit nicio eroare sau mesajul de eroare în caz contrar	OK
lista lucrărilor care aparțin proiectului, una pe fiecare linie, cu valori separate prin punct și virgulă	o linie de lucrare constă din: id;tip_lucrare;sursă;țintă;cuvinte;client_total;dată_comandă;dată_livrare;pm;pm_email	o linie de lucrare: 9687796;REVIZIE;italiană;engleză;182;10,00;ÎN CURS;2012-11-29 T15:35:00Z;2013-01-25 T16:00:00Z;GIANFRANCO;gianfranco@translated.com

Această funcție afișează lista codurilor de limbă acceptate pentru traducerea umană (pentru parametrii limbă sursă și limbă țintă ai estimării de preț și funcțiile de confirmare). Lista conține codul RFC 3066 și codurile ISO de două și trei litere.

Această funcție trebuie utilizată pentru actualizarea periodică a listei de limbi acceptate în sistemul tău.

Funcția II acceptă următorii parametri:

Parametru	Descriere	Implicit	Exemplu
cid	Nume utilizator	/	cid=hts-demo
p	Parolă	/	p=hts-demo5

Exemplu

https://www.translated.net/hts/?f=ll& Cid =hts-demo& P =hts-demo5

Funcția ll returnează următoarele câmpuri:

Parametru	Descriere	Exemplu
cod returnat	1 dacă estimarea de preț a reușit, 0 dacă a intervenit o eroare	1
lista de limbi	o linie de limbă este formată din: denumirea limbii;codul RFC3066;codul ISO 6391;codul ISO 6392	Amhară;amAM;am;amh

Această funcție afișează lista codurilor de subiect acceptate pentru traducerea umană. Această funcție trebuie utilizată pentru actualizarea periodică a listei de subiecte acceptate în sistemul tău.

Funcția subjects acceptă următorii parametri:

Parametru	Descriere	Implicit	Exemplu
cid	Nume utilizator	/	cid=hts-demo
p	Parolă	/	p=hts-demo5

Exemplu

https://www.translated.net/hts/?f=ll& Cid =hts-demo& P =hts-demo5

Funcția subjects returnează următoarele câmpuri:

Parametru	Descriere	Exemplu
cod returnat	1 dacă estimarea de preț a reușit, 0 dacă a intervenit o eroare	1
lista de subiecte	Subiectul documentului pe care dorești să îl traduci	contabilitate_finanțe apărare_aerospațială arhitectură

O estimare de preț este valabilă timp de 24 de ore.

Acceptăm orice tip de fișier, deoarece HTS este doar o modalitate de a plasa comenzi și transfera fișiere direct pe serverele noastre. Cu toate acestea, funcțiile avansate, precum numărarea automată a cuvintelor sunt disponibile numai pentru formatele pdf, txt, xml, html, xliff, rtf, doc, docx, aea. Pentru alte formate, trebuie să numeri tu cuvintele și apoi să ne trimiți numărul exact de cuvinte prin parametrul specific (consultă funcția Estimare de preț în Lista de funcții).

Documentele sunt livrate prin HTTP POST la un punct final public ales de tine. Te rugăm să nu uiți să ne trimiți aceste informații. În caz contrar, nu îți vom putea returna traducerile.

Îți vom trimite o factură pentru fiecare proiect, cu termen de plată de 5 zile. Pentru volume mari sau utilizare obișnuită, putem conveni plăți lunare.

Da, nu există fluctuații de preț. Te rugăm să reții faptul că întârzierea va fi cu atât mai mare cu cât trebuie să facem mai multe operațiuni tehnice pentru a extrage textul din fișier.

Sistemul automatizează numărarea cuvintelor prin analizarea fișierului tău, extragerea textului pur și numărarea cuvintelor. Formatele de fișiere mai bogate, cum ar fi formatele Word, pot include metadate suplimentare (comentarii în fișiere, informații despre autor etc.) care sunt extrase totuși. Acest lucru poate provoca fluctuații minore ale numărului de cuvinte. Compania Translated asigură că o inspecție detaliată a fiecărui fișier este realizată de managerii noștri de proiect pentru a se asigura că nu există nicio discrepanță majoră a numărului de cuvinte înainte de începerea traducerii.

Da. HTS acceptă orice tip de fișier. Formatele de date acceptate sunt pentru numărarea automată a cuvintelor online.

Contactează-ne la adresa hts@translated.com și vom fi bucuroși să discutăm acest aspect.

Trimite o listă de valori separate prin virgulă în parametrul „t” al apelului, după cum urmează:

https://www.translated.net/hts/?f=quote&cid=hts-demo&p=hts-demo5&s=engleză&t=japoneză,italiană,spaniolă&text=blob&df=pdf&endpoint=http://www.your-domain.com/translations/receive

Utilizează parametrul număr de cuvinte „w” în loc de „text ”, astfel:

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

În mod implicit, HTS-ul nostru răspunde cu text simplu, cu toate acestea, dacă specifici „of=json”, acesta va returna un JSON. Acest parametru opțional suplimentar este acceptat de toate funcțiile API („quote”, „confirm”, „status”, „ll”, „subjects”).

HTS-ul nostru oferă un mediu de tip sandbox pentru verificarea întregii bucle estimare de preț-confirmare-livrare, fără a face o comandă reală. Nu vor fi percepute taxe pentru proiectele tip sandbox și nu există limite privind numărul de proiecte tip sandbox pe care un utilizator le poate crea. Poți găsi o explicație detaliată în secțiunea aferentă.