Um conjunto de chamadas de API está disponível, o que permite:
-
Integração do Phrase e qualquer software de terceiros (Ferramentas de gestão de tradução, CMSs, etc.)
-
Desenvolvimento de uma bancada de trabalho do tradutor. O CAT Editor é construído sobre APIs públicas.
-
Criação de uma nova ferramenta ou serviço usando o Phrase em seu backend.
Fluxo de trabalho básico
Procedimentos e fluxo de trabalho devem ser compreendidos antes de usar APIs. Recomenda-se estar familiarizado com um procedimento no Phrase antes de implementar a API relacionada.
O fluxo de trabalho básico é:
-
Criar uma memória de tradução, glossário e, opcionalmente, adicionar um mecanismo de tradução automática.
-
Criar um projeto com a memória de tradução/glossário/mecanismo de tradução automática anexado (se necessário).
-
Gravar o projeto como um modelo de projeto e reutilizá-lo para criar um novo projeto de tradução.
-
Fazer upload do seu arquivo para tradução no projeto (criar um trabalho).
-
Você pode então analisar, Pré-traduzir ou atribuir o trabalho a um linguista.
APIs assíncronas
APIs assíncronas devem ser sempre preferidas em relação às suas contrapartes síncronas. Ao chamar APIs síncronas, há uma chance de receber respostas de tempo limite expirado ao processar grandes lotes de arquivos ou até mesmo um único arquivo grande. APIs síncronas devem ser usadas apenas para arquivos pequenos e integração em pequena escala.
Polling
Após chamar uma API assíncrona, uma resposta instantânea é recebida, incluindo o identificador da solicitação. Usar este identificador para verificar o estado da solicitação chamando getAsyncRequest e verificando o campo asyncResponse. Essa abordagem de polling pode levar a várias chamadas de getAsyncRequest antes de receber uma asyncResponse que não seja nula.
Callbacks
Como resposta às desvantagens da abordagem de polling para solicitações assíncronas, o suporte para callbacks em todas as APIs assíncronas é suportado. Ao chamar uma solicitação assíncrona, especifique uma URL (no parâmetro callbackUrl) que é solicitada após o trabalho iniciado pela solicitação assíncrona ser Concluir.
Callbacks são solicitados via chamadas HTTP POST e os dados são passados no corpo codificados como JSON. O objeto JSON sempre contém:
-
Informações sobre a solicitação assíncrona (o mesmo que ao chamar getAsyncRequest).
-
Informações detalhadas sobre o resultado da ação, como uma análise completa ou detalhes do trabalho.
{
"asyncRequest": {
...
}
"analyse": {
...
}
}
Se uma URL de callback não estiver acessível, a solicitação será repetida após 2, 4, 8, 16 e 30 minutos até que 10 tentativas tenham falhado.
A URL de callback deve responder com o código de estado HTTP 200 OK para ser considerada bem-sucedida.