{"info":{"name":"API RapidTranslate (версія 1)","_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-адреса API. За потреби можна змінити її для кожного середовища."},{"key":"apiKey","value":"YOUR_API_KEY","type":"string","description":"Ваш секретний ключ API з розділу «Налаштування бізнесу» → «Ключі API». У тестовому режимі використовуйте ключ Sandbox."},{"key":"orderId","value":"","type":"string","description":"UUID замовлення на переклад (параметр `id`, повернутий функцією «Створити замовлення»). Використовується функціями «Отримати» та «Затвердити»."}],"item":[{"name":"Довідкові дані","description":"Ознайомтеся зі списком мов та прайс-листом. Ці значення вводяться у відповідні поля під час створення замовлення.","item":[{"name":"Перелік мов","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/languages","host":["{{baseUrl}}"],"path":["languages"]},"description":"Повертає всі мови, що підтримуються. При створенні замовлення використовуйте значення `name` дослівно як `source_language` / `target_language` — замовлення зіставляються за назвою мови, а не за кодом.\n\nПотрібен ключ, для якого виконано автентифікацію."},"response":[]},{"name":"Отримати прайс-лист","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/prices","host":["{{baseUrl}}"],"path":["prices"]},"description":"Повертає базовий прайс-лист для США (у доларах США), за яким здійснюється виставлення рахунків за ваші замовлення. Суми вказані у вигляді десяткових рядків. Ціни згруповані за типом `перекладу` (кожен із яких має ціну за `одиницю` у варіантах `звичайний` та `терміновий`), способом `доставки` та `апостилем`.\n\nВартість присяжного перекладу розраховується за мовною парою — див. блок `language_pairs`.\n\nОбласть застосування: `price:read`"},"response":[]}]},{"name":"Замовлення","description":"Створювати, переглядати, перелічувати та затверджувати замовлення на переклад.","item":[{"name":"Створити замовлення","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"reference","value":"APO-10432","type":"text","description":"Ваш власний унікальний ідентифікатор замовлення. Повторне використання цього ідентифікатора повертає існуюче замовлення (ідемпотентність)."},{"key":"customer[name]","value":"Jane Doe","type":"text","description":"Повне ім'я кінцевого споживача."},{"key":"customer[email]","value":"jane@example.com","type":"text","description":"Електронна адреса кінцевого клієнта."},{"key":"source_language","value":"Spanish","type":"text","description":"Точна назва мови зі списку мов."},{"key":"target_language","value":"English (US)","type":"text","description":"Точна назва мови зі списку мов."},{"key":"translation_type","value":"certified","type":"text","description":"Один із сертифікованих, стандартних, спеціалізованих, присяжних, NAATI."},{"key":"turnaround","value":"regular","type":"text","description":"звичайний або прискорений."},{"key":"delivery[method]","value":"email","type":"text","description":"Один із варіантів: email, notarized_email, mail_standard, mail_next_day."},{"key":"delivery[address][street]","value":"","type":"text","description":"Необхідно для послуг «mail_standard» / «mail_next_day».","disabled":true},{"key":"delivery[address][city]","value":"","type":"text","disabled":true},{"key":"delivery[address][state]","value":"","type":"text","description":"Необов’язково.","disabled":true},{"key":"delivery[address][postal_code]","value":"","type":"text","disabled":true},{"key":"delivery[address][country]","value":"US","type":"text","description":"Код країни за стандартом ISO, наприклад, US.","disabled":true},{"key":"apostille[enabled]","value":"false","type":"text","description":"Додати оформлення апостилю (мова перекладу має бути англійською; необхідна опція mail_standard).","disabled":true},{"key":"apostille[documents]","value":"1","type":"text","description":"Кількість документів, які потрібно завірити апостилем. Вказується, якщо ця опція увімкнена.","disabled":true},{"key":"apostille[destination_country]","value":"","type":"text","description":"Країна, для якої призначена апостиль.","disabled":true},{"key":"notes","value":"","type":"text","description":"Інструкції у вигляді вільного тексту.","disabled":true},{"key":"coupon_code","value":"","type":"text","description":"Код на знижку, який потрібно застосувати.","disabled":true},{"key":"files[]","type":"file","src":[],"description":"1–20 файлів. Допустимі формати: pdf, jpg, jpeg, png, doc, docx, tiff, heic. Максимальний розмір кожного файлу — 20 МБ."}]},"url":{"raw":"{{baseUrl}}/orders","host":["{{baseUrl}}"],"path":["orders"]},"description":"Створює замовлення на переклад і завантажує вихідні файли. Використовує `multipart/form-data`, оскільки цей формат підтримує передачу файлів. Вкладені поля позначаються у дужках, наприклад, `customer[name]`.\n\nДодайте принаймні один файл під ключем `files[]` (виберіть файл у стовпці «значення»).\n\nЩойно створене замовлення спочатку має статус `pending` із сумою `null`, поки розраховується вартість. Виконуйте запит для отримання замовлення або стежте за веб-хуком `order_status`, щоб побачити оновлення ціни.\n\nІдемпотентність: повторне створення з тим самим `reference` повертає існуюче замовлення з кодом 200 замість дубліката (нове замовлення повертає код 201).\n\nОбласть дії: `orders:write`"},"response":[]},{"name":"Отримати замовлення","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}","host":["{{baseUrl}}"],"path":["orders","{{orderId}}"]},"description":"Витягує одне замовлення за його `id` (UUID, повернутий під час створення). Спочатку слід встановити змінну колекції `orderId`. Повертає код 404 not_found, якщо замовлення не належить вашій організації.\n\nОбласть дії: `orders:read`"},"response":[]},{"name":"Список замовлень","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":"Один із таких статусів: «у процесі», «очікує затвердження», «обробляється», «завершено», «скасовано»."},{"key":"per_page","value":"50","description":"1–100. За замовчуванням використовується стандартний розмір сторінки."},{"key":"reference","value":"","description":"Відфільтруйте за вашим номером.","disabled":true},{"key":"source_language","value":"","description":"Фільтрувати за назвою мови.","disabled":true},{"key":"target_language","value":"","description":"Фільтрувати за назвою мови.","disabled":true},{"key":"created_from","value":"","description":"Початкова дата діапазону (включно).","disabled":true},{"key":"created_to","value":"","description":"Кінцева дата діапазону (включно).","disabled":true},{"key":"sort","value":"-created_at","description":"-created_at (за замовчуванням, спочатку найновіші) або created_at (спочатку найстаріші).","disabled":true},{"key":"page","value":"1","description":"Номер сторінки.","disabled":true}]},"description":"Повертає замовлення вашої організації, починаючи з найновіших, із пагінацією, вказаною в `meta`. Усі параметри запиту є необов’язковими.\n\nОбласть дії: `orders:read`"},"response":[]},{"name":"Затвердити наказ","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}/approve","host":["{{baseUrl}}"],"path":["orders","{{orderId}}","approve"]},"description":"Затверджує розраховану загальну суму замовлення, що перебуває у стані `awaiting_approval`, та активує його для виконання. Потрібно лише в тому випадку, якщо для вашого облікового запису необхідне затвердження перед початком роботи. Цей виклик є ідемпотентним.\n\nЯкщо замовлення не очікує на затвердження, ви отримаєте код 409 not_awaiting_approval; якщо потрібно здійснити списання коштів, але воно не вдалося, ви отримаєте код 402 payment_failed або 402 credit_hold.\n\nОбласть дії: `orders:write`"},"response":[]}]}]}