Documentación de la API de traducción
Autenticación, una primera consulta segura y el ciclo del pedido con ejemplos de PHP nativo. La API v1 admite texto, documentos y audio según los permisos de la cuenta.
https://api.translate24.pro/v1Acceso y autenticación
Contacta con nosotros para acordar la cuenta y sus permisos. Las cuentas nativas utilizan un token Bearer emitido. Esta versión no ofrece un panel para generar claves de empresa por cuenta propia. Contactar
Authorization: Bearer YOUR_API_TOKENGuarda el token en una variable de entorno o configuración protegida del servidor. Usa HTTPS. Nunca incluyas credenciales en URL, JavaScript del navegador o repositorios públicos.
Un hash de contraseña guardado no es una contraseña de API. El SSO del sitio y la autenticación de la API son mecanismos distintos.
Primera consulta
Empieza consultando tu perfil. Esta petición no crea pedidos ni cobra del saldo.
curl --request GET \
'https://api.translate24.pro/v1/user/view' \
--header "Authorization: Bearer $TRANSLATE24_API_TOKEN" \
--header 'Accept: application/json'Configura TRANSLATE24_API_TOKEN en tu servidor. Comprueba el estado HTTP y el JSON: una respuesta correcta contiene un objeto user.
Consulta los catálogos actuales y usa los identificadores devueltos. Los identificadores de ejemplo pueden no estar disponibles para tu cuenta.
GET /languages/get-pairsGET /languages/get-themesGET /languages/get-typesGET /order/get-data-for-create-order
PHP nativo
Este ejemplo de solo lectura utiliza la extensión cURL de PHP y no necesita un framework.
<?php
$token = getenv('TRANSLATE24_API_TOKEN');
if (!is_string($token) || $token === '') {
throw new RuntimeException('API token is not configured.');
}
$ch = curl_init('https://api.translate24.pro/v1/user/view');
if ($ch === false) {
throw new RuntimeException('Unable to initialize cURL.');
}
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $token,
'Accept: application/json',
],
]);
$body = curl_exec($ch);
$httpStatus = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($body === false) {
// Keep diagnostic details in a protected server log.
throw new RuntimeException('API connection failed.');
}
$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if ($httpStatus < 200 || $httpStatus >= 300) {
throw new RuntimeException('API HTTP error: ' . $httpStatus);
}
if (!is_array($data) || isset($data['errors'])
|| !isset($data['user']) || !is_array($data['user'])) {
throw new RuntimeException('Unexpected API response.');
}
$user = $data['user'];Guarda el perfil en el servidor y muestra solo los campos necesarios. El ejemplo no imprime datos de clientes ni credenciales.
Ciclo del pedido
- Elige idiomas, tipo y tema de los catálogos. POST /order/create-as-draft crea un registro sin iniciar automáticamente un trabajo de pago.
- Comprueba errors, order, price e infoMessage en la respuesta. Algunos documentos requieren recuento manual de palabras.
- POST /order/in-work?id=ORDER_ID&pay_by=1 puede descontar saldo e iniciar el trabajo. Obtén aprobación expresa antes de llamarlo.
- Sigue el progreso mediante GET /order/view?id=ORDER_ID o GET /order/index. Limita la frecuencia de consulta.
Campos del borrador
| Campos del borrador | Significado |
|---|---|
type | 1: texto · 2: archivos · 3: audio |
source_type | 1: salida de texto · 2: salida de audio |
language_pair_id | ID del catálogo, o from_language_code y to_language_code. |
translate_type_id | ID del tipo de traducción del catálogo |
translate_theme_id | ID del tema del catálogo |
source_text | Texto original de un pedido de texto |
uploadSourceFiles[] | Carga multipart de archivos o audio |
user_id | Opcional: cliente creado por el socio autenticado. De lo contrario, el pedido pertenece a la cuenta autenticada. |
Usa campos de formulario para texto y multipart/form-data para archivos. Deja que el cliente HTTP genere el delimitador multipart.
En in-work, pay_by=1 utiliza el saldo de la cuenta autenticada; pay_by=2 el del propietario del pedido y requiere los permisos de socio y la vinculación de cliente adecuados.
Archivos y audio
Documentos: txt, odt, pdf, docx; hasta 5 archivos de 5 MiB cada uno. Audio: mp3, ogg, webm; hasta 5 archivos de 15 MiB cada uno.
Revisa cada respuesta de carga. Un ID de pedido no autoriza por sí solo el trabajo de pago si falla el análisis o el recuento de palabras.
Errores y reintentos
401: revisa la autenticación. 403: revisa permisos. 404: revisa ID y titularidad. Una respuesta 2xx con errors es un fallo de aplicación; algunas validaciones devuelven HTTP 200.
Tras un tiempo de espera agotado o 5xx, una escritura puede haberse realizado. Revisa el estado antes de reintentar. No repitas automáticamente creación, pago o eliminación: no hay un contrato publicado de claves de idempotencia. Las lecturas pueden reintentarse de forma limitada y con espera.
Cuentas externas
Las cuentas externas usan su mecanismo Basic admitido y solo pueden leer su perfil, historial de traducciones y catálogos permitidos. No pueden crear, enviar a trabajo ni eliminar pedidos. Acuerda una cuenta nativa de integración o socio para escribir.
Referencia de endpoints
Las rutas son relativas a la URL base. El acceso depende de los permisos. Consulta Swagger para los parámetros o contacta con nosotros para obtener acceso.
| Método | Ruta | Finalidad |
|---|---|---|
| GET | /user/view | Tu perfil |
| GET | /user/list | Clientes del socio |
| POST | /user/registration | Crear cliente del socio |
| POST | /user/delete | Eliminar cliente del socio |
| GET | /order/index | Pedidos accesibles |
| GET | /order/view | Detalles del pedido |
| GET | /order/get-data-for-create-order | Opciones del pedido |
| POST | /order/create-as-draft | Crear borrador |
| POST | /order/in-work | Aprobar pago e iniciar trabajo |
| POST | /order/delete | Eliminar pedido permitido |
| GET | /languages/get-pairs | Pares de idiomas |
| GET | /languages/get-themes | Temas |
| GET | /languages/get-types | Tipos de traducción |