Autenticación

Las claves de API, sus modos, el límite de peticiones y el id de cada petición.

Cada petición lleva tu clave de API como token Bearer. La dirección base es https://api.translaqe.com y todas las rutas empiezan por /v1.

POST /v1/translate HTTP/1.1
Host: api.translaqe.com
Authorization: Bearer tq_live_…
Content-Type: application/json

Solo GET /v1/languages se puede pedir sin clave.

Las claves

Las claves se crean y se revocan en la aplicación web, en Claves de API. Una clave se enseña una vez, al crearla: TranslaQE solo guarda su huella, así que no se puede volver a enseñar. Si la pierdes, crea otra y revoca la anterior.

Una clave actúa en nombre de toda tu organización: traduce, lee todos los documentos y gestiona memorias, glosarios y proyectos. Trátala como una contraseña.

Guárdala en tu servidor, en una variable de entorno o en un gestor de secretos.
No la pongas nunca en una página web, en una aplicación móvil ni en un repositorio público. La API no acepta llamadas desde navegadores de otras webs.
Usa una clave por integración, con su nombre: así revocas una sin parar las demás.

Claves de producción y de prueba

Una clave es live (tq_live_…) o test (tq_test_…). Las dos funcionan igual. Lo que se hace con una de prueba se cuenta aparte: GET /v1/usage?group_by=mode y GET /v1/requests las distinguen, así las cifras de tus pruebas de integración no se mezclan con las de producción.

Límite de peticiones

Cada clave puede hacer 120 peticiones por minuto. Todas las respuestas dicen cómo vas:

Cabecera	Qué dice
`RateLimit-Limit`	Peticiones permitidas por minuto.
`RateLimit-Remaining`	Las que quedan en este minuto.
`RateLimit-Reset`	Segundos que faltan para que la cuenta vuelva a empezar.

Pasado el límite la respuesta es 429, con el tipo rate-limited y una cabecera Retry-After: espera esos segundos y repite la petición.

El id de cada petición

Todas las respuestas llevan la cabecera X-Request-Id (req_…), también las de error. Guárdala en tus registros: es lo que necesitamos para seguir una petición, y GET /v1/requests/{request_id} enseña lo que la API anotó de ella.

Si mandas tu propio X-Request-Id, se guarda aparte como client_request_id.