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.

URL basehttps://api.translate24.pro/v1

Acceso 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_TOKEN

Guarda 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
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-pairs
  • GET /languages/get-themes
  • GET /languages/get-types
  • GET /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
<?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

  1. 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.
  2. Comprueba errors, order, price e infoMessage en la respuesta. Algunos documentos requieren recuento manual de palabras.
  3. 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.
  4. Sigue el progreso mediante GET /order/view?id=ORDER_ID o GET /order/index. Limita la frecuencia de consulta.

Campos del borrador

Campos del borradorSignificado
type1: texto · 2: archivos · 3: audio
source_type1: salida de texto · 2: salida de audio
language_pair_idID del catálogo, o from_language_code y to_language_code.
translate_type_idID del tipo de traducción del catálogo
translate_theme_idID del tema del catálogo
source_textTexto original de un pedido de texto
uploadSourceFiles[]Carga multipart de archivos o audio
user_idOpcional: 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étodoRutaFinalidad
GET/user/viewTu perfil
GET/user/listClientes del socio
POST/user/registrationCrear cliente del socio
POST/user/deleteEliminar cliente del socio
GET/order/indexPedidos accesibles
GET/order/viewDetalles del pedido
GET/order/get-data-for-create-orderOpciones del pedido
POST/order/create-as-draftCrear borrador
POST/order/in-workAprobar pago e iniciar trabajo
POST/order/deleteEliminar pedido permitido
GET/languages/get-pairsPares de idiomas
GET/languages/get-themesTemas
GET/languages/get-typesTipos de traducción

Swagger ↗ · Contactar