Menselijke vertalingsserver API

U vraagt ​​een offerte aan om een ​​bestelling te plaatsen op ons systeem door een oproep (GET of POST) te geven op de volgende URL:

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

Een voorbeeld:

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

Op dit punt hebben we het bestand al opgehaald, opgeslagen op onze systemen en een project geïnitialiseerd. Deze oproep blijft hangen totdat we de hele blob hebben opgehaald, hoe sneller uw internetlink, hoe beter.

Tip: als u een langzame internetverbinding heeft, kunt u overwegen het bestand ergens van tevoren te uploaden en ons vervolgens de URL van dat bestand in de tekstparameter door te geven, zie Functielijst voor meer informatie.

We vereisen ook dat u het eindpunt opgeeft waarnaar uw vertaalde bestand wordt afgeleverd. Houd er rekening mee dat we zonder een eindpunt de vertaling niet aan u kunnen leveren.

Ons systeem haalt de ruwe tekst uit uw document, telt de woorden (als u niet expliciet de telling in het verzoek heeft opgegeven) via de w parameter (
ie de Funtielijst voor meer details) en brengt daarna een offerte uit met daarin:

	Betekenis
1	De oproep is geslaagd
OK	"OK" of een foutmelding, als er een fout was
2013-09-26T15:30:00Z	Gegarandeerde leverdatum in Zulu tijd (ISO 8601)
3082	Het aantal woorden zoals door ons geteld
216,99	Prijs in Euro
1040734	De id voor deze quote (project-id)

Houd er rekening mee dat uw project nog niet is gestart, we geven u alleen de volgende informatie:

Om de bestelling te bevestigen, moet u een bevestigingsoproep plaatsen

Nadat u de offerte hebt beoordeeld en goedgekeurd, bevestigt u deze door de project-ID terug te sturen:

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

Hier is een voorbeeld:

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

Zoals eerder, werken beide GET- of POST-methoden prima. Als de bevestiging is gelukt, kunt u het volgende antwoord verwachten:

	Betekenis
1	De oproep is geslaagd
Oké	"OK" of een foutmelding, als er een fout was

Dat was het! Het project is bevestigd en is overhandigd aan een van onze projectmanagers, die zullen zorgen voor de selectie van de meest geschikte vertaler voor uw bestand. Vanaf nu gaat het allemaal gemakkelijk.

Zodra we het vertaalde bestand van de professional hebben ontvangen, bekijken we het zorgvuldig. Als het de kwaliteitscontrole doorstaat, wordt het bestand teruggebracht naar een HTTP-eindpunt dat aan uw zijde wordt weergegeven, dat u eerder met ons hebt afgesproken (bijvoorbeeld: http://www.uw-domein.com/translations/receive.php).

Dit eindpunt mag op elk moment een POST van ons verwachten, met de volgende velden:

Als u meerdere doeltalen hebt besteld, kunt u een afzonderlijke oproep verwachten voor elke doeltaal. Het belangrijkste verschil met de offerte is dat offerte een "pull-oriented" -functie is die door u wordt uitgevoerd, terwijl de levering een "push-gerichte" functie is die door ons wordt geactiveerd.

Hier is een voorbeeld:

Parameter	Omschrijving
Retourcode	1 als de levering geslaagd is 0 als er een fout is opgetreden
Foutmelding	"OK" als er geen fout was, of anders de foutmelding. De foutmelding moet begrijpelijk zijn en uitleggen wat er mis ging.

Neem voor een gepersonaliseerde callback-workflow contact met ons op via hts@translated.com.

Onze HTS wordt geleverd met een sandbox-omgeving voor testdoeleinden, waarmee we vertaalaanvragen kunnen genereren en verzenden zonder een echte bestelling te maken. De sandbox-omgeving vertegenwoordigt een nauwkeurige abstractie van de API-procedure. Het biedt u de mogelijkheid om het hele proces in actie te zien, van de offerte tot de levering.

Wanneer u een project bevestigt waarvoor u eerder een offerte hebt aangevraagd ("f=confirm"), is het voldoende om de parameter "sandbox=1" toe te voegen om dat project als een API-test te bevestigen, zoals dit:

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

Let er op dat de offertefunctie hetzelfde is voor testen en productie. Bovendien zal de tekst van het geleverde bericht niet de vertaling zijn, maar dezelfde tekst die u ons tijdens de offerte stuurde.

Als er meerdere doeltalen in de offerte staan, verwacht u meerdere leveringen in een willekeurige hoeveelheid tijd tussen 30 seconden en 2 minuten.

Het gedrag van de sandbox weerspiegelt de echte en stelt u in staat de hele loop te testen voor uw integratie.

Deze functie retourneert de prijs en leverdatum voor een menselijke vertaling. Dit is de eerste stap in het bestellen van een menselijke vertaling met behulp van onze HTS.

Het vereist ten minste de parameter tekst of de parameter w om een ​​geldig antwoord te retourneren. Dit betekent dat u een geldige offerte kunt krijgen zonder uw document daadwerkelijk te verzenden als u tenminste het aantal woorden verstrekt.

De offerte-functie accepteert de volgende parameters:

Parameter	Omschrijving	Standaard	Voorbeeld
cid	Gebruikersnaam	/	cid = hts-demo
p	Wachtwoord	/	p=hts-demo5
s	Brontaal	/	s=Engels
t	Doeltaal/-talen Door komma's gescheiden waarden voor meerdere doelen	/	t =Italiant =Italiaans, Spaans, Japans
tekst	De content die moet worden vertaald. Dit kan een in-line platte tekst zijn of een URL die naar het bestand verwijst. Weet dat het optioneel is als de parameter w is gespecificeerd.	/	text = Hello worldtext = "http://www.translated.com/hts/HTS_Tech_Spec.pdf"
pn	Projectnaam	HTS-NONAME	pn = Vertaling voor morgen nr. 2
jt	Type klussen: T for Professional ⇥⇥⇥⇥⇥⇥R for Premium ⇥⇥⇥⇥⇥⇥P for Economy	T	jt=R
w	Aantal woorden voor dit bestand. Deze parameter vermijdt dat onze server het aantal woorden in realtime voor het bestand berekent, wat resulteert in snellere reacties.	/	w=5120
df	Gegevensindeling, als de extensie van het bestand. Noodzakelijk voor automatisch tellen van woorden. Automatisch tellen van woorden is alleen beschikbaar voor: 'pdf', 'platte tekst', 'txt', 'xml', 'html', 'htm', 'xliff', 'zip', 'rtf', 'doc', ' docx', 'aea'. Geef "zip" op om meerdere bestanden gezipt te verzenden, we zullen automatisch de bestandsindeling van de content inschatten.	/	df=zip
tm	Een vertaalgeheugen dat u voor dit project wilt gebruiken. Wat tekstparameters betreft, kan een bestand of een URL zijn. Houd er rekening mee dat u ook een MyMemory-sleutel kunt doorgeven.	/	tm= 823yuc908237tm =http://www.yousite.net/hts/some_memory.tmx
eindpunt	De url waarvan u wilt dat wij de vertaling naar u sturen. We raden u aan om uw eindpunt URL-coderen om te voorkomen dat er problemen met het parseren zijn, vooral wanneer uw link "&" of andere speciale tekens bevat.	/	eindpunt=http://www.mysite.com/path/to/mypage.extURL-encoded : eindpunt=http%3A%2F%2Fwww.mysite.com%2Fpath%2Fto%2Fmypage.ext
onderwerp	Het onderwerp van het document dat u verzendt. Controleer de lijst met ondersteunde onderwerpen API-methode voor een volledige lijst.	algemeen	subject=accounting_finance
instructies	Geef een reeks instructies voor de vertaler op, in platte tekst	/	instructies=laat alles in kleine letters, datums zijn in Amerikaanse indeling

Voorbeeld

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

De offerte-functie retourneert de volgende velden:

Parameter	Omschrijving	Voorbeeld
retourcode	1 als de offerte geslaagd is 0 als er een fout is opgetreden	1
foutmelding	"Oké" als er geen fout was, of anders de foutmelding	Oké
leveringsdatum	De datum en tijd die de gegarandeerde deadline voor de bestelling aangeven, in ISO 8601-norm: JJJJ-MM-DDTHH: mm: SSZ	2013-02-18T12:32:00Z
tellen van woorden	Aantal woorden gegeven in de tekstparameter, ofwel geteld door ons of ingediend door de gebruiker met "w" parameter	456
kosten in Euro's	Kosten in Euro voor de bestelling, opgemaakt als een getal zonder scheidingsteken voor duizendtallen en "." als decimaal scheidingsteken	223,33
project-ID	De project-ID dat moet worden gebruikt wanneer u deze bestelling wilt bevestigen	10454289

Deze functie bevestigt een eerder aangevraagde offerte voor een menselijke vertaling. Dit is de tweede en laatste stap in het plaatsen van een bestelling voor menselijke vertaling met HTS.

De offerte-functie accepteert de volgende parameters:

Parameter	Omschrijving	Standaard	Voorbeeld
cid	Gebruikersnaam	/	cid = hts-demo
p	Wachtwoord	/	p=hts-demo5
pid	De project-ID die moet worden gebruikt wanneer u deze bestelling wilt bevestigen	/	pid=10454289
c	Bevestig markering.U bevestigt een offerte in de "bevestig" -functie door 1 toe te wijzen aan deze parameter, en een offerte te weigeren door 0 toe te wijzen.	/	c= 1c=0
sandbox	Sandbox-modus. In deze modus wordt het project beschouwd als een test en wordt de te vertalen content naar het eindpunt verzonden zoals het is. Geen aangerekende kosten.	0	sandbox=1
tekst	De content die moet worden vertaald. Dit kan zijn: een in-line platte tekst/binaire blob ⇥⇥⇥⇥⇥⇥een URL die naar het bestand verwijst	/	text = Hello worldtext = "http://www.translated.com/hts/HTS_Tech_Spec.pdf"

Voorbeeld

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

De offerte-functie retourneert de volgende velden:

Parameter	Omschrijving	Voorbeeld
retourcode	1 als de offerte geslaagd is 0 als er een fout is opgetreden	1
foutmelding	"Oké" als er geen fout was, of anders de foutmelding	OK

Met deze functie kunt u de status van alle projecten dat u hebt ingediend volgen.

De offerte-functie accepteert de volgende parameters:

Parameter	Omschrijving	Standaard	Voorbeeld
cid	Gebruikersnaam	/	cid = hts-demo
p	Wachtwoord	/	p=hts-demo5
pid	De project-ID die moet worden gebruikt wanneer u deze bestelling wilt bevestigen	/	pid=10454289

Voorbeeld

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

De status-functie retourneert de volgende velden:

Parameter	Omschrijving	Voorbeeld
retourcode	1 als de offerte geslaagd is 0 als er een fout is opgetreden	1
foutmelding	"Oké" als er geen fout was, of anders de foutmelding	OK
lijst met taken die bij het project horen, één per regel, gescheiden door puntkomma's	een taakregel bestaat uit: id; job_type; source; target; woorden; customer_total; order_date; delivery_date; pm; pm_email	eenmalige taak: 9687796; REVISION; Italiaans; Engels; 182; 10.00; IN PROCES; 2012-11-29 T15: 35: 00Z; 2013-01-25 T16: 00: 00Z; GIANFRANCO; gianfranco@translated.com

Deze functie toont de lijst met taalcodes die worden ondersteund voor menselijke vertaling (voor de bron- en doelparameters van de quote en bevestig functies). De lijst bevat de RFC 3066-code, de ISO-codes voor twee en drie letters.

Deze functie moet worden gebruikt om de ondersteunde talenlijst op uw systeem regelmatig bij te werken

De offerte-functie accepteert de volgende parameters:

Parameter	Omschrijving	Standaard	Voorbeeld
cid	Gebruikersnaam	/	cid = hts-demo
p	Wachtwoord	/	p=hts-demo5

Voorbeeld

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

De II-functie retourneert de volgende velden:

Parameter	Omschrijving	Voorbeeld
retourcode	1 als de offerte geslaagd is 0 als er een fout is opgetreden	1
lijst met talen	een taallijn bestaat uit: taalnaam;RFC3066-code;ISO 6391-code;ISO 6392-code	Amharic;am;AM;am;amh

Deze functie toont de lijst met onderwerpcodes die worden ondersteund voor menselijke vertaling. Deze functie moet worden gebruikt om de ondersteunde talenlijst op uw systeem regelmatig bij te werken

De onderwerp-functie accepteert de volgende parameters:

Parameter	Omschrijving	Standaard	Voorbeeld
cid	Gebruikersnaam	/	cid = hts-demo
p	Wachtwoord	/	p=hts-demo5

Voorbeeld

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

De onderwerpen-functie retourneert de volgende velden:

Parameter	Omschrijving	Voorbeeld
retourcode	1 als de offerte geslaagd is 0 als er een fout is opgetreden	1
lijst van onderwerpen	Het onderwerp van het document dat u wilt vertalen	accounting_ financeaerospace_ defencearchitecture

Een offerte is 24 uur geldig.

We ondersteunen elk bestandtype, aangezien HTS slechts een manier is om bestellingen te plaatsen en bestanden rechtstreeks naar onze servers over te sturen. Geavanceerde functies zoals automatisch woorden tellen, zijn echter alleen beschikbaar voor pdf, txt, xml, html, xliff, rtf, doc, docx, aea. Voor andere bestandtypes moet u handmatig woorden tellen en ons dan het exacte aantal woorden via de specifieke parameter sturen (zie Offertefunctie in de functielijst).

Documenten worden via HTTP POST geleverd aan een openbaar eindpunt van uw keuze. Vergeet alsjeblieft niet om ons deze informatie te mailen, anders kunnen we uw vertalingen niet aan u leveren.

We sturen u een factuur voor elk project met een betalingstermijn van vijf dagen. Bij veel vertalingen of regelmatig gebruik kunnen we maandelijkse betalingen afspreken.

Ja, geen prijsschommeling. Houd er rekening mee dat hoe meer techniek we moeten uitvoeren om de tekst uit het bestand te extraheren, hoe groter de vertraging.

Het systeem automatiseert het tellen van woorden door uw bestand te ontleden, de ruwe tekst en telwoorden te extraheren. Rijkere bestandsindelingen, zoals Word-indelingen, kunnen extra metadata bevatten (bestandsopmerkingen, auteursinformatie, enz.) die niettemin worden geëxtraheerd. Dit kan kleine fluctuaties van het aantal woorden veroorzaken. Translated zorgt ervoor dat onze projectmanagers een grondige inspectie van elk bestand uitvoeren, om ervoor te zorgen dat er geen grote verschillen in het aantal woorden aanwezig zijn voordat met de vertaling wordt begonnen.

Ja. HTS ondersteunt elk bestandstype, de ondersteunde gegevensindelingen zijn voor het online geautomatiseerd tellen van woorden.

Neem contact met ons op via hts@translated.com en we bespreken het graag.

Stuur een lijst met door komma's gescheiden waarden in de parameter "t" van de oproep, zoals deze:

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

Gebruik de parameter woordtelling "w" in plaats van "tekst", zoals deze:

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

Onze HTS antwoordt standaard met ruwe tekst, maar als u "of=json" opgeeft, retourneert deze een JSON. Deze extra optionele parameter wordt ondersteund door alle API-functies ("offerte", "bevestigen", "status", "ll", "onderwerpen").

Onze HTS biedt een sandbox-omgeving voor het controleren van de volledige offerte-bevestigen-afleveringsloop, zonder een echte bestelling te maken. Er worden geen kosten in rekening gebracht voor sandbox-projecten en er zijn geen grenzen aan het aantal sandbox-projecten dat een gebruiker kan maken. Zoek een gedetailleerde uitleg bij de gerelateerde sectie.