{"info":{"name":"RapidTranslate-API (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":"Basis-URL für die API. Bei Bedarf je nach Umgebung überschreiben."},{"key":"apiKey","value":"YOUR_API_KEY","type":"string","description":"Dein geheimer API-Schlüssel aus den Geschäftseinstellungen → API-Schlüssel. Verwende für den Testmodus einen Sandbox-Schlüssel."},{"key":"orderId","value":"","type":"string","description":"Eine UUID für einen Übersetzungsauftrag (die von „Auftrag erstellen“ zurückgegebene `id`). Wird von „Abrufen“ und „Genehmigen“ verwendet."}],"item":[{"name":"Referenzdaten","description":"Lesen Sie die Sprachenliste und die Preisliste durch. Diese Werte werden in die Felder übernommen, die Sie bei der Erstellung eines Auftrags übermitteln.","item":[{"name":"Sprachen auflisten","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/languages","host":["{{baseUrl}}"],"path":["languages"]},"description":"Gibt alle unterstützten Sprachen zurück. Verwenden Sie den Wert „name“ unverändert als „source_language“ bzw. „target_language“ beim Erstellen einer Bestellung – Bestellungen werden anhand des Sprachnamens abgeglichen, nicht anhand des Codes.\n\nErfordert einen authentifizierten Schlüssel."},"response":[]},{"name":"Preisliste abrufen","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/prices","host":["{{baseUrl}}"],"path":["prices"]},"description":"Gibt die US-Basispreisliste in USD zurück, auf deren Grundlage Ihre Aufträge abgerechnet werden. Die Beträge sind Dezimalzeichenfolgen. Die Preise sind nach dem Typ „`translation`“ (jeweils mit einem „`regular`“- und einem „`rapid`“-Preis pro „`unit`“), der „`delivery`“-Methode und der „`apostille`“ gruppiert.\n\nBeglaubigte Übersetzungen werden pro Sprachpaar berechnet – siehe den Block „`language_pairs`“.\n\nGültigkeitsbereich: `price:read`"},"response":[]}]},{"name":"Bestellungen","description":"Übersetzungsaufträge erstellen, abrufen, auflisten und genehmigen.","item":[{"name":"Bestellung aufgeben","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"reference","value":"APO-10432","type":"text","description":"Ihre eigene, eindeutige Bestellnummer. Bei erneuter Verwendung wird die bestehende Bestellung zurückgegeben (idempotent)."},{"key":"customer[name]","value":"Jane Doe","type":"text","description":"Vollständiger Name des Endkunden."},{"key":"customer[email]","value":"jane@example.com","type":"text","description":"E-Mail des Endkunden."},{"key":"source_language","value":"Spanish","type":"text","description":"Genauer Name der Sprache aus der Liste der Sprachen."},{"key":"target_language","value":"English (US)","type":"text","description":"Genauer Name der Sprache aus der Liste der Sprachen."},{"key":"translation_type","value":"certified","type":"text","description":"Einer von: zertifiziert, standardisiert, spezialisiert, vereidigt, NAATI."},{"key":"turnaround","value":"regular","type":"text","description":"normal oder schnell."},{"key":"delivery[method]","value":"email","type":"text","description":"Entweder „E-Mail“, „notariell beglaubigte E-Mail“, „Standard-Post“ oder „Express-Post“."},{"key":"delivery[address][street]","value":"","type":"text","description":"Erforderlich für „mail_standard“ / „mail_next_day“.","disabled":true},{"key":"delivery[address][city]","value":"","type":"text","disabled":true},{"key":"delivery[address][state]","value":"","type":"text","description":"Optional.","disabled":true},{"key":"delivery[address][postal_code]","value":"","type":"text","disabled":true},{"key":"delivery[address][country]","value":"US","type":"text","description":"ISO-Ländercode, z. B. US.","disabled":true},{"key":"apostille[enabled]","value":"false","type":"text","description":"Apostille-Bearbeitung hinzufügen (Zielsprache muss Englisch sein; erfordert „mail_standard“).","disabled":true},{"key":"apostille[documents]","value":"1","type":"text","description":"Anzahl der mit einer Apostille zu versehenden Dokumente. Erforderlich, wenn diese Option aktiviert ist.","disabled":true},{"key":"apostille[destination_country]","value":"","type":"text","description":"Land, für das die Apostille bestimmt ist.","disabled":true},{"key":"notes","value":"","type":"text","description":"Anweisungen im Freitext.","disabled":true},{"key":"coupon_code","value":"","type":"text","description":"Ein Rabattcode, den Sie einlösen können.","disabled":true},{"key":"files[]","type":"file","src":[],"description":"1–20 Dateien. Zulässige Dateiformate: pdf, jpg, jpeg, png, doc, docx, tiff, heic. Maximal 20 MB pro Datei."}]},"url":{"raw":"{{baseUrl}}/orders","host":["{{baseUrl}}"],"path":["orders"]},"description":"Erstellt einen Übersetzungsauftrag und lädt die Quelldateien hoch. Verwendet `multipart/form-data`, da damit Dateien übertragen werden. Verschachtelte Felder verwenden die Klammernotation, z. B. `customer[name]`.\n\nFügen Sie mindestens eine Datei unter dem Schlüssel `files[]` hinzu (wählen Sie eine Datei in der Wertespalte aus).\n\nEin neu erstellter Auftrag beginnt mit dem Status `pending` und einem Gesamtbetrag von `null`, während der Preis berechnet wird. Rufen Sie einen Auftrag ab oder warten Sie auf den Webhook `order_status`, um die Preisaktualisierung zu sehen.\n\nIdempotenz: Wird ein Erstellungsvorgang mit derselben `reference` wiederholt, wird der bestehende Auftrag mit dem Status 200 zurückgegeben, anstatt eines Duplikats (ein neuer Auftrag gibt den Status 201 zurück).\n\nGültigkeitsbereich: `orders:write`"},"response":[]},{"name":"Eine Bestellung abrufen","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}","host":["{{baseUrl}}"],"path":["orders","{{orderId}}"]},"description":"Ruft eine einzelne Bestellung anhand ihrer `id` (die bei der Erstellung zurückgegebene UUID) ab. Legen Sie zunächst die Sammlungsvariable `orderId` fest. Gibt den Status 404 not_found zurück, wenn die Bestellung nicht zu Ihrer Organisation gehört.\n\nGültigkeitsbereich: `orders:read`"},"response":[]},{"name":"Bestellungen auflisten","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":"„In Bearbeitung“, „Zur Genehmigung“, „In Bearbeitung“, „Abgeschlossen“, „Storniert“."},{"key":"per_page","value":"50","description":"1–100. Standardmäßig wird die Standardseitengröße verwendet."},{"key":"reference","value":"","description":"Nach Ihrer Referenznummer filtern.","disabled":true},{"key":"source_language","value":"","description":"Nach Sprachbezeichnung filtern.","disabled":true},{"key":"target_language","value":"","description":"Nach Sprachbezeichnung filtern.","disabled":true},{"key":"created_from","value":"","description":"Startdatum des Zeitraums (einschließlich).","disabled":true},{"key":"created_to","value":"","description":"Ende des Datumsbereichs (einschließlich).","disabled":true},{"key":"sort","value":"-created_at","description":"-created_at (Standard, neueste zuerst) oder created_at (älteste zuerst).","disabled":true},{"key":"page","value":"1","description":"Seitenzahl.","disabled":true}]},"description":"Gibt die Bestellungen Ihrer Organisation zurück, beginnend mit den neuesten, mit Paginierung in `meta`. Alle Abfrageparameter sind optional.\n\nGültigkeitsbereich: `orders:read`"},"response":[]},{"name":"Eine Bestellung genehmigen","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}/approve","host":["{{baseUrl}}"],"path":["orders","{{orderId}}","approve"]},"description":"Genehmigt den berechneten Gesamtbetrag für einen Auftrag, der den Status „awaiting_approval“ hat, und leitet damit die Auftragsabwicklung ein. Dies ist nur erforderlich, wenn für Ihr Konto vor Beginn der Arbeiten eine Genehmigung erforderlich ist. Der Aufruf ist idempotent.\n\nWenn der Auftrag nicht zur Genehmigung ansteht, erhalten Sie den Status 409 „not_awaiting_approval“; wenn eine Abbuchung erforderlich ist, diese jedoch fehlschlägt, erhalten Sie den Status 402 „payment_failed“ oder 402 „credit_hold“.\n\nGültigkeitsbereich: `orders:write`"},"response":[]}]}]}