Regístrate como Desarrollador y Obtén una Clave API
Proporciona APIs RESTful para la traducción de documentos, con soporte para la gestión automatizada de tareas de traducción, coherencia terminológica basada en glosarios y consultas sobre formatos, idiomas y modelos compatibles, facilitando la creación de flujos de trabajo de traducción eficientes y la gestión de cuentas de usuario.
Primeros pasos
Para comenzar, debe solicitar convertirse en desarrollador.Solicitar como desarrollador
Una vez aprobado, podrá crear múltiples claves API e incluir la clave API correspondiente en cada solicitud API según sea necesario.
Acceso rápido
URL Base
https://otranslator.com/api
Método de autenticación
Authorization: [yourSecretKey]
Solicitud JSON
Excepto la interfaz de carga de archivos, las interfaces utilizan por defecto solicitudes POST JSON, con Content-Type application/json.
Carga de archivo
La creación de una tarea de traducción de documentos utiliza multipart/form-data, el campo file envía el archivo a traducir.
Respuesta de error general
Cuando la solicitud falla, la interfaz devolverá JSON, el campo error contiene un mensaje de error fijo en inglés. Se recomienda priorizar el manejo de errores por código de estado HTTP, el campo error se utiliza para mostrar o para registro en logs.
{
"error": "Invalid API key."
}Reglas de código de estado de error
Todas las respuestas de error de la API v1 mantienen la misma estructura, procéselas según las siguientes reglas de código de estado HTTP.
- 400 Bad Request
- Faltan parámetros requeridos, formatos de parámetros o valores enum inválidos, falta el archivo cargado, fallo al guardar la carga, o fallo en el procesamiento de la tarea.
- 401 Unauthorized
- Falta la clave API o es inválida.
- 402 Payment Required
- Saldo de créditos insuficiente para vista previa, traducción completa o traducción de texto.
- 404 Not Found
- La tarea o el glosario no existe, ha sido eliminado, no pertenece a la cuenta API actual, o no fue creado a través de la API.
- 409 Conflict
- El estado actual de la tarea no permite la operación solicitada.
- 500 Internal Server Error
- Excepción inesperada del servidor. El error de respuesta está fijado como "Error interno del servidor.".
Proceso de integración recomendado
1. Crear tarea
Cargar archivo y crear tarea de traducción, devuelve el taskId.
2. Consultar progreso
Consultar el estado de la tarea hasta que esté Completed, Terminated o Cancelled.
3. Obtener resultado
Descargar archivo de traducción, o leer el JSON del original y la traducción.
4. Gestionar tareas
Paga según el uso por traducción de texto completo, reinicio de tareas, revisión de textos o eliminación de tareas.