{"info":{"name":"Interfejs API RapidTranslate (wersja 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":"Podstawowy adres URL interfejsu API. W razie potrzeby można go dostosować dla poszczególnych środowisk."},{"key":"apiKey","value":"YOUR_API_KEY","type":"string","description":"Twój tajny klucz API z sekcji „Ustawienia biznesowe” → „Klucze API”. W trybie testowym użyj klucza z środowiska Sandbox."},{"key":"orderId","value":"","type":"string","description":"UUID zlecenia tłumaczenia (identyfikator `id` zwracany przez metodę „Utwórz zlecenie”). Wykorzystywany przez metody „Pobierz” i „Zatwierdź”."}],"item":[{"name":"Dane referencyjne","description":"Zapoznaj się z listą języków i cennikiem. Wartości te są wprowadzane w polach, które wypełniasz podczas tworzenia zamówienia.","item":[{"name":"Wyświetl języki","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/languages","host":["{{baseUrl}}"],"path":["languages"]},"description":"Zwraca wszystkie obsługiwane języki. Podczas tworzenia zamówienia należy użyć wartości `name` dosłownie jako `source_language` / `target_language` — zamówienia są dopasowywane na podstawie nazwy języka, a nie kodu.\n\nWymagany jest klucz uwierzytelniony."},"response":[]},{"name":"Uzyskaj cennik","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/prices","host":["{{baseUrl}}"],"path":["prices"]},"description":"Zwraca cennik bazowy dla Stanów Zjednoczonych, w USD, na podstawie którego rozliczane są Twoje zamówienia. Kwoty są przedstawione jako ciągi dziesiętne. Ceny są pogrupowane według typu `tłumaczenia` (każdy z ceną `standardową` i `ekspresową` za `jednostkę`), metody `dostawy` oraz `apostille`.\n\nCena tłumaczenia przysięgłego jest ustalana na parę językową — zobacz blok `language_pairs`.\n\nZakres: `price:read`"},"response":[]}]},{"name":"Zamówienia","description":"Tworzenie, wyszukiwanie, przeglądanie i zatwierdzanie zleceń tłumaczeniowych.","item":[{"name":"Utwórz zamówienie","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"reference","value":"APO-10432","type":"text","description":"Twój unikalny numer referencyjny zamówienia. Ponowne użycie tego numeru zwraca istniejące zamówienie (idempotentne)."},{"key":"customer[name]","value":"Jane Doe","type":"text","description":"Pełne imię i nazwisko klienta końcowego."},{"key":"customer[email]","value":"jane@example.com","type":"text","description":"Adres e-mail klienta końcowego."},{"key":"source_language","value":"Spanish","type":"text","description":"Dokładna nazwa języka z listy języków."},{"key":"target_language","value":"English (US)","type":"text","description":"Dokładna nazwa języka z listy języków."},{"key":"translation_type","value":"certified","type":"text","description":"Jeden z certyfikowanych, standardowych, wyspecjalizowanych, przysięgłych, NAATI."},{"key":"turnaround","value":"regular","type":"text","description":"zwykły lub szybki."},{"key":"delivery[method]","value":"email","type":"text","description":"„One of email”, „notarized_email”, „mail_standard”, „mail_next_day”."},{"key":"delivery[address][street]","value":"","type":"text","description":"Wymagane w przypadku usług „mail_standard” i „mail_next_day”.","disabled":true},{"key":"delivery[address][city]","value":"","type":"text","disabled":true},{"key":"delivery[address][state]","value":"","type":"text","description":"Opcjonalnie.","disabled":true},{"key":"delivery[address][postal_code]","value":"","type":"text","disabled":true},{"key":"delivery[address][country]","value":"US","type":"text","description":"Kod kraju zgodny z normą ISO, np. US.","disabled":true},{"key":"apostille[enabled]","value":"false","type":"text","description":"Dodaj usługę poświadczenia apostille (językiem docelowym musi być angielski; wymagana opcja „mail_standard”).","disabled":true},{"key":"apostille[documents]","value":"1","type":"text","description":"Liczba dokumentów do apostille. Wymagana, gdy ta opcja jest włączona.","disabled":true},{"key":"apostille[destination_country]","value":"","type":"text","description":"Kraj, którego dotyczy apostille.","disabled":true},{"key":"notes","value":"","type":"text","description":"Instrukcje w formie swobodnego tekstu.","disabled":true},{"key":"coupon_code","value":"","type":"text","description":"Kod rabatowy do wykorzystania.","disabled":true},{"key":"files[]","type":"file","src":[],"description":"1–20 plików. Dopuszczalne formaty: pdf, jpg, jpeg, png, doc, docx, tiff, heic. Maksymalny rozmiar każdego pliku to 20 MB."}]},"url":{"raw":"{{baseUrl}}/orders","host":["{{baseUrl}}"],"path":["orders"]},"description":"Tworzy zlecenie tłumaczenia i przesyła pliki źródłowe. Wykorzystuje format `multipart/form-data`, ponieważ umożliwia on przesyłanie plików. Pola zagnieżdżone są zapisywane w notacji nawiasowej, np. `customer[name]`.\n\nNależy dołączyć co najmniej jeden plik pod kluczem `files[]` (wybierz plik w kolumnie „wartość”).\n\nNowo utworzone zlecenie ma początkowo status `pending` i sumę `null`, podczas gdy trwa obliczanie ceny. Wywołaj zapytanie, aby pobrać zlecenie lub nasłuchuj webhooka `order_status`, aby sprawdzić aktualizację ceny.\n\nIdempotencja: powtórzenie operacji tworzenia z tym samym `reference` zwraca istniejące zlecenie z kodem 200 zamiast duplikatu (nowe zlecenie zwraca kod 201).\n\nZakres: `orders:write`"},"response":[]},{"name":"Pobierz zamówienie","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}","host":["{{baseUrl}}"],"path":["orders","{{orderId}}"]},"description":"Pobiera pojedyncze zamówienie na podstawie jego `id` (identyfikatora UUID zwróconego podczas tworzenia). Najpierw należy ustawić zmienną kolekcji `orderId`. Zwraca kod 404 not_found, jeśli zamówienie nie należy do Twojej organizacji.\n\nZakres: `orders:read`"},"response":[]},{"name":"Zamówienia na liście","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":"Jeden z następujących statusów: „w toku”, „oczekuje na zatwierdzenie”, „w trakcie przetwarzania”, „zakończone”, „anulowane”."},{"key":"per_page","value":"50","description":"1–100. Domyślnie jest to standardowy rozmiar strony."},{"key":"reference","value":"","description":"Filtruj według odniesienia.","disabled":true},{"key":"source_language","value":"","description":"Filtruj według nazwy języka.","disabled":true},{"key":"target_language","value":"","description":"Filtruj według nazwy języka.","disabled":true},{"key":"created_from","value":"","description":"Początek zakresu dat (włącznie).","disabled":true},{"key":"created_to","value":"","description":"Koniec zakresu dat (włącznie).","disabled":true},{"key":"sort","value":"-created_at","description":"-created_at (domyślnie, najnowsze najpierw) lub created_at (najstarsze najpierw).","disabled":true},{"key":"page","value":"1","description":"Numer strony.","disabled":true}]},"description":"Zwraca zamówienia Twojej organizacji, zaczynając od najnowszych, z paginacją określoną w `meta`. Wszystkie parametry zapytania są opcjonalne.\n\nZakres: `orders:read`"},"response":[]},{"name":"Zatwierdź zamówienie","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}/approve","host":["{{baseUrl}}"],"path":["orders","{{orderId}}","approve"]},"description":"Zatwierdza obliczoną sumę zamówienia o statusie `awaiting_approval`, uruchamiając tym samym jego realizację. Jest to wymagane tylko wtedy, gdy konto użytkownika wymaga zatwierdzenia przed rozpoczęciem realizacji. Wywołanie to jest idempotentne.\n\nJeśli zamówienie nie oczekuje na zatwierdzenie, otrzymujesz kod błędu 409 „not_awaiting_approval”; jeśli wymagana jest opłata, ale nie powiodła się, otrzymujesz kod błędu 402 „payment_failed” lub 402 „credit_hold”.\n\nZakres: `orders:write`"},"response":[]}]}]}