Hay disponible un conjunto de llamadas API que permiten:
-
integración de phrase y cualquier software de terceros (Herramientas de gestión de traducción, CMS, etc.)
-
Desarrollo del banco de trabajo de un traductor. CAT Editor se basa en las API públicas.
-
Creación de una herramienta o servicio completamente nuevo utilizando phrase en su back-end.
Flujo de trabajo básico
Los procedimientos y flujos de trabajo deben entenderse antes de usar las API. Se recomienda familiarizarse con un procedimiento en phrase antes de implementar la API relacionada.
El flujo de trabajo básico es:
-
Crear una TM, TB y, opcionalmente, agregar un motor de traducción automática.
-
Crear un proyecto con el TM / TB / motor de traducción automática conectado (si es necesario).
-
Guardar el proyecto como plantilla del proyecto y reutilizarlo para crear un nuevo proyecto de traducción.
-
Carga el archivo para su traducción al proyecto (crear un trabajo).
-
Entonces puedes analizar, pretraducir o asignar el trabajo a un lingüista.
API asíncronas
Las API asíncronas siempre deben preferirse a sus homólogas síncronas. Si se llama a API síncronas, existe la posibilidad de que se agote el tiempo de respuesta al procesar lotes grandes de archivos o incluso un solo archivo grande. Las API síncronas solo deben usarse para archivos pequeños e integración a pequeña escala.
Sondeo
Después de llamar a una API asíncrona, se recibe una respuesta instantánea que incluye la solicitud de identificador. Usa este identificador para comprobar el estado de la solicitud llamando a getAsyncRequest y marcando el campo asyncResponse. Este enfoque de encuesta puede llevar a varias llamadas getAsyncRequest antes de recibir una respuestaasincr que no sea nula.
Devoluciones
Como respuesta a los inconvenientes del enfoque de sondeo para las solicitudes asíncronas, se admite la devolución de llamadas en todas las API asíncronas. Al llamar a una solicitud asíncrona, especifique una URL (en el parámetro callbackUrl) que se solicite una vez Completado el trabajo iniciado por la solicitud asíncrona.
Las devoluciones de llamadas se solicitan a través de llamadas POST HTTP y los datos se pasan al cuerpo codificado como JSON. El objeto JSON siempre contiene:
-
Información sobre la solicitud asíncrona (la misma que cuando se llama a getAsyncRequest).
-
Información detallada sobre el resultado de la acción como un análisis completo o detalles del trabajo.
{
"asyncRequest": {
...
}
"analizar": {
...
}
}
Si no se puede acceder a una URL de rellamada, la solicitud se repite después de 2, 4, 8, 16 y 30 minutos hasta que hayan fallado 10 reintentos.
La URL de rellamada debe responder con el código de estado HTTP 200 OK para considerarse exitosa.