Hay un conjunto de API calls disponible que permite:
-
Integración de Phrase y cualquier software de terceros (herramientas de gestión de traducción, CMS, etc.)
-
Desarrollo de una mesa de trabajo para traductores. El CAT Editor está construido sobre APIs públicas.
-
Creación de una herramienta o servicio completamente nuevo usando Phrase en su backend.
Flujo de trabajo básico
Debes entender los procedimientos y el flujo de trabajo antes de usar las APIs. Te recomendamos familiarizarte con un procedimiento en Phrase antes de implementar la API relacionada.
El flujo de trabajo básico es:
-
Crear un 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 adjunto (si es necesario).
-
Guardar el proyecto como una plantilla de proyecto y reutilizarlo para crear un nuevo proyecto de traducción.
-
Carga tu archivo para traducción al proyecto (crea un trabajo).
-
Luego puedes analizar, pretraducir o asignar el trabajo a un lingüista.
APIs asíncronas
Te recomendamos usar siempre las APIs asíncronas en lugar de sus contrapartes sincrónicas. Si llamas a las APIs sincrónicas, podrías recibir respuestas de tiempo de espera expirado al procesar grandes lotes de archivos o incluso un solo archivo grande. Solo utiliza las APIs sincrónicas para archivos pequeños y para integraciones a pequeña escala.
Sondeo
Después de llamar a una API asíncrona, recibirás una respuesta instantánea que incluye el identificador de la solicitud. Usa este identificador para verificar el estado de la solicitud llamando a getAsyncRequest y comprobando el campo asyncResponse. Este enfoque de sondeo puede provocar que se realicen varias llamadas getAsyncRequest antes de recibir una asyncResponse que no sea nula.
Callbacks
Como respuesta a las desventajas del sondeo en las solicitudes asíncronas, puedes usar callbacks en todas las APIs asíncronas. Al llamar a una solicitud asíncrona, especifica una URL (en el parámetro callbackUrl) que se solicita después de que el trabajo iniciado por la solicitud asíncrona se complete.
Los callbacks se solicitan a través de llamadas HTTP POST y los datos se envían 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": {
...
}
"analizar": {
...
}
}
Si una URL de callback no es accesible, la solicitud se repite después de 2, 4, 8, 16 y 30 minutos hasta que fallen 10 reintentos.
La URL de callback debe responder con el código de estado HTTP 200 OK para que se considere exitosa.