Un conjunto de llamadas a la API está disponible, lo cual permite:
-
Integración de Phrase y cualquier software de terceros (Herramientas de gestión de traducción, CMS, etc.)
-
Desarrollo de un banco de trabajo para el traductor. El CAT Editor está construido sobre API públicas.
-
Creación de una nueva herramienta o servicio utilizando Phrase en su backend.
Flujo de trabajo básico
Los procedimientos y el flujo de trabajo deben entenderse antes de usar las API. Se recomienda estar familiarizado 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 la TM/TB/motor de traducción automática adjunto (si es necesario).
-
Guardar el proyecto como una plantilla de proyecto y reutilizarla para crear un nuevo proyecto de traducción.
-
Cargar su archivo para traducción al proyecto (crear un trabajo).
-
Luego puede analizar, Pretraducir o asignar el trabajo a un lingüista.
API asíncronas
Siempre se deben preferir las API asíncronas a sus contrapartes síncronas. Si llama a API síncronas, existe la posibilidad de recibir respuestas de tiempo de espera agotado al procesar grandes lotes de archivos o incluso un solo archivo grande. Las API síncronas solo deben usarse para archivos pequeños y una integración a pequeña escala.
Polling
Después de llamar a una API asíncrona, se recibe una respuesta instantánea que incluye el identificador de la solicitud. Usar este identificador para verificar el estado de la solicitud llamando a getAsyncRequest y verificando el campo asyncResponse. Este enfoque de sondeo puede llevar a una cantidad de llamadas a getAsyncRequest antes de recibir una asyncResponse que no sea nula.
Callbacks
Como respuesta a los inconvenientes del enfoque de sondeo para solicitudes asíncronas, se admite el uso de callbacks en todas las API asíncronas. Al llamar a una solicitud asíncrona, especifique una URL (en el parámetro callbackUrl) que se solicita después de que el trabajo iniciado por la solicitud asíncrona esté Completar.
Los callbacks se solicitan mediante llamadas HTTP POST y los datos se pasan en el cuerpo codificados como JSON. El objeto JSON siempre contiene:
-
Información sobre la solicitud asíncrona (la misma que al llamar a getAsyncRequest).
-
Información detallada sobre el resultado de la acción, como un análisis completo o detalles del trabajo.
{
"asyncRequest": {
...
}
"analyse": {
...
}
}
Si una URL de callback no es accesible, la solicitud se repite después de 2, 4, 8, 16 y 30 minutos hasta que 10 reintentos hayan fallado.
La URL de callback debe responder con el código de estado HTTP 200 OK para considerarse exitosa.