Documentación de la API

Desarrolladores

La API de TriExpert Translations es una API HTTP pública y de sólo lectura. Calcula el precio de una traducción certificada y comprueba si una traducción certificada es auténtica. Sin clave, sin registro, sin darse de alta.

Para qué sirve la API de TriExpert Translations

Presupuestar. Saber cuánto cuesta una traducción certificada antes de mandar a nadie a un formulario.
Verificar. Confirmar que un documento con un código TX-XXXX-XXXX lo emitimos nosotros — útil para cualquier agencia, empleador o universidad que reciba uno.
Leer la tarifa. Consultar el precio por página y los multiplicadores vigentes para reproducir el cálculo por tu cuenta.

Lo que a propósito no hace es encargar traducciones. Un encargo implica subir un documento y cobrar, y eso necesita una persona: usa el formulario de solicitud o escribe a support@triexpertservice.com.

Especificación OpenAPI

La especificación completa, OpenAPI 3.1, se genera a partir de las rutas y las tarifas vivas, así que no puede quedarse desfasada respecto a lo que la API hace de verdad:

https://traduccionestriexpert.com/openapi.json

URL base de todos los endpoints:

https://traduccionestriexpert.com/wp-json/triexpert/v1

GET /quote — estimar un precio

Una página son 250 palabras. processing es standard (8–12 h) o urgent (1–2 h). format es digital, physical o both.

curl 'https://traduccionestriexpert.com/wp-json/triexpert/v1/quote?pages=3&processing=standard&format=digital'

La estimación no es vinculante: el precio en firme se fija cuando recibimos el documento y contamos sus páginas reales.

GET /verify/{code} — comprobar una traducción certificada

Cada traducción certificada que emitimos lleva un código impreso y un QR. La comprobación es pública, no caduca y no revela ningún dato personal del cliente.

curl https://traduccionestriexpert.com/wp-json/triexpert/v1/verify/TX-4F2A-9C31

Mira el campo status: authentic, in_progress, cancelled o unknown. Un código no reconocido responde 200 con status unknown, no 404 — la pregunta se ha contestado, así que no es una ruta que falte.

GET /rates — la tarifa vigente

Devuelve el precio base por página, los multiplicadores de urgencia y de formato doble, y la fórmula exacta, para poder calcular un precio en local sin una ida y vuelta.

curl https://traduccionestriexpert.com/wp-json/triexpert/v1/rates

Errores

Todos los errores son problem details de la RFC 9457, servidos como application/problem+json. Nunca una página HTML de error. El objeto lleva siempre un code legible por máquina para ramificar, un detail para una persona y una resolution que dice qué hacer:

{
  "type": "https://traduccionestriexpert.com/developers/#errors-rest-invalid-param",
  "title": "Un parámetro no vale",
  "status": 400,
  "detail": "Invalid parameter(s): pages",
  "instance": "https://traduccionestriexpert.com/wp-json/triexpert/v1/quote?pages=abc",
  "code": "rest_invalid_param",
  "resolution": "pages es un entero de 1 a 999; processing es standard o urgent; format es digital, physical o both.",
  "documentation": "https://traduccionestriexpert.com/developers/"
}

Los códigos sobre los que puedes ramificar:

rest_missing_callback_param — 400. Falta un parámetro obligatorio.
rest_invalid_param — 400. Un parámetro es de otro tipo o está fuera de rango.
rest_no_route — 404. Ningún endpoint casa con esa URL.
tx_not_api — 404. La ruta parece una llamada a una API, pero no es de las nuestras.
tx_method_not_allowed — 405. La API es de sólo lectura; todo responde a GET.
tx_rate_limited — 429. Demasiadas peticiones desde tu dirección.
tx_internal — 500. Culpa nuestra, no tuya.

Conviene decirlo claro: un código de verificación no reconocido no es un error. /verify/{code} responde 200 con "status": "unknown", porque la pregunta se ha contestado: no hemos emitido ese documento. Un 404 ahí significaría que falta el endpoint, que es otro problema muy distinto.

Las mismas formas están declaradas en la especificación OpenAPI, en components/schemas/Problem, así que un cliente generado obtiene una sola clase de error tipada en vez de cuatro conjeturas.

Límite de peticiones

60 peticiones cada 10 minutos, por IP y por endpoint. Al pasarse, la API responde 429. No hay cuota diaria. Si necesitas más margen, escríbenos y cuéntanos qué estás construyendo.

Leer el sitio en Markdown

Todas las páginas se sirven también en Markdown. Pídelo por cabecera, o añade .md a la URL:

curl -H 'Accept: text/markdown' https://traduccionestriexpert.com/es/precios/
curl https://traduccionestriexpert.com/es/precios.md

/llms.txt — el índice corto para agentes, con cuándo este servicio es y no es el adecuado.
/llms-full.txt — todas las páginas públicas en un solo archivo Markdown.
/wp-sitemap.xml — el mapa del sitio.
/openapi.json — la especificación de la API.

Condiciones de uso

Los endpoints son de uso libre. No uses el de verificación para enumerar códigos: está para comprobar un documento que tienes delante, no para barrer el espacio de códigos. Te pedimos que identifiques tu cliente en el User-Agent, para poder distinguirte de un raspador si algo se ve raro.

Dudas, o algo que falte en esta página: support@triexpertservice.com.