{"info":{"name":"API de RapidTranslate (v1)","_postman_id":"rt-api-v1-0000-0000-0000-000000000001","description":"Official Postman collection for the RapidTranslate certified-translation API.\n\nPlace and track orders, list languages and pricing, and approve orders programmatically.\n\n## Getting started\n1. Import this collection into Postman (File → Import).\n2. Open the collection variables and set **apiKey** to a key generated in *Business Settings → API Keys*.\n3. (Optional) Point **baseUrl** at your environment. It defaults to production.\n\nEvery request already sends `Authorization: Bearer {{apiKey}}` and `Accept: application/json`.\n\nUse a **Sandbox** key to run against the fully simulated environment (no billing, no fulfillment). Responses and webhooks carry a `livemode` flag so you can tell the two apart.\n\nFull documentation: https://www.rapidtranslate.org/developers","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{apiKey}}","type":"string"}]},"variable":[{"key":"baseUrl","value":"https://www.rapidtranslate.org/api/v1","type":"string","description":"URL base de la API. Modifícala según el entorno si es necesario."},{"key":"apiKey","value":"YOUR_API_KEY","type":"string","description":"Tu clave API secreta, que encontrarás en «Configuración empresarial» → «Claves API». Utiliza una clave de Sandbox para el modo de prueba."},{"key":"orderId","value":"","type":"string","description":"Un UUID de pedido de traducción (el `id` devuelto por la función «Crear un pedido»). Lo utilizan las funciones «Recuperar» y «Aprobar»."}],"item":[{"name":"Datos de referencia","description":"Lee la lista de idiomas y la tarifa. Estos datos se introducen en los campos que debes rellenar al crear un pedido.","item":[{"name":"Lista de idiomas","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/languages","host":["{{baseUrl}}"],"path":["languages"]},"description":"Devuelve todos los idiomas admitidos. Utiliza el valor de `name` tal cual como `source_language` / `target_language` al crear un pedido; los pedidos se emparejan por el nombre del idioma, no por el código.\n\nRequiere una clave autenticada."},"response":[]},{"name":"Consulta la lista de precios","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/prices","host":["{{baseUrl}}"],"path":["prices"]},"description":"Devuelve la tarifa de referencia de EE. UU., en USD, según la cual se facturan tus pedidos. Los importes son cadenas decimales. Los precios se agrupan por tipo de «traducción» (cada uno con un precio «normal» y «rápido» por «unidad»), método de «entrega» y «apostilla».\n\nLa traducción jurada se cobra por par de idiomas; consulta el bloque «language_pairs».\n\nÁmbito: «price:read»"},"response":[]}]},{"name":"Pedidos","description":"Crear, consultar, listar y aprobar pedidos de traducción.","item":[{"name":"Realizar un pedido","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"reference","value":"APO-10432","type":"text","description":"Tu propia referencia de pedido única. Si la vuelves a utilizar, se recuperará el pedido existente (idempotente)."},{"key":"customer[name]","value":"Jane Doe","type":"text","description":"Nombre y apellidos completos del cliente final."},{"key":"customer[email]","value":"jane@example.com","type":"text","description":"Correo electrónico del cliente final."},{"key":"source_language","value":"Spanish","type":"text","description":"Nombre exacto del idioma de la lista de idiomas."},{"key":"target_language","value":"English (US)","type":"text","description":"Nombre exacto del idioma de la lista de idiomas."},{"key":"translation_type","value":"certified","type":"text","description":"Uno de certificada: estándar, especializado, jurado, naati."},{"key":"turnaround","value":"regular","type":"text","description":"normal o rápido."},{"key":"delivery[method]","value":"email","type":"text","description":"Uno de los siguientes: correo electrónico, correo electrónico certificado, correo estándar, correo con entrega al día siguiente."},{"key":"delivery[address][street]","value":"","type":"text","description":"Obligatorio para los servicios «mail_standard» y «mail_next_day».","disabled":true},{"key":"delivery[address][city]","value":"","type":"text","disabled":true},{"key":"delivery[address][state]","value":"","type":"text","description":"Opcional.","disabled":true},{"key":"delivery[address][postal_code]","value":"","type":"text","disabled":true},{"key":"delivery[address][country]","value":"US","type":"text","description":"Código ISO del país, p. ej., EE. UU.","disabled":true},{"key":"apostille[enabled]","value":"false","type":"text","description":"Añadir la tramitación de la apostilla (el idioma de destino debe ser el inglés; requiere el servicio «mail_standard»).","disabled":true},{"key":"apostille[documents]","value":"1","type":"text","description":"Número de documentos que deben llevar la apostilla. Obligatorio cuando esté activada.","disabled":true},{"key":"apostille[destination_country]","value":"","type":"text","description":"País para el que se destina la apostilla.","disabled":true},{"key":"notes","value":"","type":"text","description":"Instrucciones en formato de texto libre.","disabled":true},{"key":"coupon_code","value":"","type":"text","description":"Un código de descuento que debes aplicar.","disabled":true},{"key":"files[]","type":"file","src":[],"description":"De 1 a 20 archivos. Formatos admitidos: pdf, jpg, jpeg, png, doc, docx, tiff, heic. Máximo 20 MB cada uno."}]},"url":{"raw":"{{baseUrl}}/orders","host":["{{baseUrl}}"],"path":["orders"]},"description":"Crea un pedido de traducción y sube los archivos de origen. Utiliza `multipart/form-data` porque permite enviar archivos. Los campos anidados utilizan la notación entre corchetes, p. ej., `customer[name]`.\n\nAdjunta al menos un archivo bajo la clave `files[]` (selecciona un archivo en la columna «valor»).\n\nUn pedido recién creado comienza con el estado «pending» y un total «null» mientras se calcula el precio. Realiza una consulta para recuperar un pedido o escucha el webhook «order_status» para ver la actualización del precio.\n\nIdempotencia: si se repite una operación de creación con la misma «reference», se devuelve el pedido existente con el código de estado 200 en lugar de un duplicado (un nuevo pedido devuelve el código de estado 201).\n\nÁmbito: «orders:write»"},"response":[]},{"name":"Consultar un pedido","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}","host":["{{baseUrl}}"],"path":["orders","{{orderId}}"]},"description":"Recupera un único pedido por su `id` (el UUID devuelto al crearlo). Establece primero la variable de colección `orderId`. Devuelve el código de error 404 not_found si el pedido no pertenece a tu organización.\n\nÁmbito: `orders:read`"},"response":[]},{"name":"Lista de pedidos","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders?status=completed&per_page=50","host":["{{baseUrl}}"],"path":["orders"],"query":[{"key":"status","value":"completed","description":"«Pendiente», «en espera de aprobación», «en trámite», «completado» o «cancelado»."},{"key":"per_page","value":"50","description":"1–100. Por defecto, se utiliza el tamaño de página estándar."},{"key":"reference","value":"","description":"Filtra por tu referencia.","disabled":true},{"key":"source_language","value":"","description":"Filtrar por nombre de idioma.","disabled":true},{"key":"target_language","value":"","description":"Filtrar por nombre de idioma.","disabled":true},{"key":"created_from","value":"","description":"Fecha inicial del intervalo (incluida).","disabled":true},{"key":"created_to","value":"","description":"Fecha final del intervalo (incluida).","disabled":true},{"key":"sort","value":"-created_at","description":"-created_at (por defecto, de más reciente a más antiguo) o created_at (de más antiguo a más reciente).","disabled":true},{"key":"page","value":"1","description":"Número de página.","disabled":true}]},"description":"Devuelve los pedidos de tu organización, ordenados de más reciente a más antiguo, con paginación en `meta`. Todos los parámetros de consulta son opcionales.\n\nÁmbito: `orders:read`"},"response":[]},{"name":"Aprobar una orden","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}/approve","host":["{{baseUrl}}"],"path":["orders","{{orderId}}","approve"]},"description":"Aprueba el total calculado de un pedido que se encuentra en estado «awaiting_approval», activando así su tramitación. Solo es necesario cuando tu cuenta requiere aprobación antes de que comience el proceso. La llamada es idempotente.\n\nSi el pedido no está «a la espera de aprobación», se obtiene el código de error 409 «not_awaiting_approval»; si se requiere un cargo pero este falla, se obtiene el código de error 402 «payment_failed» o 402 «credit_hold».\n\nÁmbito: `orders:write`"},"response":[]}]}]}