{"info":{"name":"API 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 di base dell'API. Se necessario, sovrascriverlo in base all'ambiente."},{"key":"apiKey","value":"YOUR_API_KEY","type":"string","description":"La tua chiave API segreta, disponibile in Impostazioni aziendali → Chiavi API. Utilizza una chiave Sandbox per la modalità di prova."},{"key":"orderId","value":"","type":"string","description":"UUID di un ordine di traduzione (l'`id` restituito dalla funzione \"Crea un ordine\"). Utilizzato dalle funzioni \"Recupera\" e \"Approva\"."}],"item":[{"name":"Dati di riferimento","description":"Leggi l'elenco delle lingue e il listino prezzi. Questi valori vengono inseriti nei campi da compilare al momento della creazione di un ordine.","item":[{"name":"Elenco delle lingue","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/languages","host":["{{baseUrl}}"],"path":["languages"]},"description":"Restituisce tutte le lingue supportate. Utilizzare il valore `name` tal quale come `source_language` / `target_language` durante la creazione di un ordine: gli ordini vengono abbinati in base al nome della lingua, non al codice.\n\nRichiede una chiave autenticata."},"response":[]},{"name":"Richiedi il listino prezzi","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/prices","host":["{{baseUrl}}"],"path":["prices"]},"description":"Restituisce il listino prezzi di riferimento per gli Stati Uniti, in USD, in base al quale vengono fatturati i tuoi ordini. Gli importi sono stringhe decimali. I prezzi sono raggruppati per tipo di `traduzione` (ciascuno con un prezzo per `unità` `standard` e `rapido`), metodo di `consegna` e `apostille`.\n\nIl prezzo della traduzione giurata è calcolato per coppia linguistica — vedi il blocco `language_pairs`.\n\nAmbito: `price:read`"},"response":[]}]},{"name":"Ordini","description":"Creare, recuperare, visualizzare l'elenco e approvare gli ordini di traduzione.","item":[{"name":"Crea un ordine","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"reference","value":"APO-10432","type":"text","description":"Il tuo codice ordine univoco. Reutilizzandolo si ottiene l'ordine esistente (idempotente)."},{"key":"customer[name]","value":"Jane Doe","type":"text","description":"Nome e cognome completi del cliente finale."},{"key":"customer[email]","value":"jane@example.com","type":"text","description":"Indirizzo e-mail del cliente finale."},{"key":"source_language","value":"Spanish","type":"text","description":"Nome esatto della lingua tratto dall'elenco delle lingue."},{"key":"target_language","value":"English (US)","type":"text","description":"Nome esatto della lingua tratto dall'elenco delle lingue."},{"key":"translation_type","value":"certified","type":"text","description":"Uno tra: certificato, standard, specializzato, giurato, NAATI."},{"key":"turnaround","value":"regular","type":"text","description":"normale o rapida."},{"key":"delivery[method]","value":"email","type":"text","description":"Una delle seguenti opzioni: email, email_autenticata, posta_standard, posta_con_consegna_il_giorno_successivo."},{"key":"delivery[address][street]","value":"","type":"text","description":"Obbligatorio per mail_standard / mail_next_day.","disabled":true},{"key":"delivery[address][city]","value":"","type":"text","disabled":true},{"key":"delivery[address][state]","value":"","type":"text","description":"Facoltativo.","disabled":true},{"key":"delivery[address][postal_code]","value":"","type":"text","disabled":true},{"key":"delivery[address][country]","value":"US","type":"text","description":"Codice ISO del Paese, ad esempio US.","disabled":true},{"key":"apostille[enabled]","value":"false","type":"text","description":"Aggiungi la procedura di apostille (la lingua di destinazione deve essere l’inglese; richiede mail_standard).","disabled":true},{"key":"apostille[documents]","value":"1","type":"text","description":"Numero di documenti da apostillare. Obbligatorio se l'opzione è attivata.","disabled":true},{"key":"apostille[destination_country]","value":"","type":"text","description":"Paese per il quale è richiesta l'apostille.","disabled":true},{"key":"notes","value":"","type":"text","description":"Istruzioni in formato testo libero.","disabled":true},{"key":"coupon_code","value":"","type":"text","description":"Un codice sconto da utilizzare.","disabled":true},{"key":"files[]","type":"file","src":[],"description":"Da 1 a 20 file. Formati consentiti: pdf, jpg, jpeg, png, doc, docx, tiff, heic. Dimensione massima: 20 MB ciascuno."}]},"url":{"raw":"{{baseUrl}}/orders","host":["{{baseUrl}}"],"path":["orders"]},"description":"Crea un ordine di traduzione e carica i file di origine. Utilizza `multipart/form-data` poiché consente il trasferimento di file. I campi nidificati utilizzano la notazione tra parentesi quadre, ad esempio `customer[name]`.\n\nAllega almeno un file sotto la chiave `files[]` (seleziona un file nella colonna del valore).\n\nUn ordine appena creato parte con lo stato `pending` e un totale `null` mentre viene calcolato il prezzo. Effettua un polling per recuperare un ordine o ascolta il webhook `order_status` per vedere l'aggiornamento del prezzo.\n\nIdempotenza: ripetere un'operazione di creazione con lo stesso `reference` restituisce l'ordine esistente con codice di stato 200 invece di un duplicato (un nuovo ordine restituisce 201).\n\nAmbito: `orders:write`"},"response":[]},{"name":"Recuperare un ordine","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}","host":["{{baseUrl}}"],"path":["orders","{{orderId}}"]},"description":"Recupera un singolo ordine in base al suo `id` (l'UUID restituito al momento della creazione). Imposta prima la variabile di raccolta `orderId`. Restituisce il codice di errore 404 not_found se l'ordine non appartiene alla tua organizzazione.\n\nAmbito: `orders:read`"},"response":[]},{"name":"Elenco degli ordini","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":"Uno tra: in sospeso, in attesa di approvazione, in elaborazione, completato, annullato."},{"key":"per_page","value":"50","description":"1–100. Per impostazione predefinita, viene utilizzato il formato pagina standard."},{"key":"reference","value":"","description":"Filtra in base al tuo codice di riferimento.","disabled":true},{"key":"source_language","value":"","description":"Filtra per nome della lingua.","disabled":true},{"key":"target_language","value":"","description":"Filtra per nome della lingua.","disabled":true},{"key":"created_from","value":"","description":"Data di inizio dell'intervallo (compresa).","disabled":true},{"key":"created_to","value":"","description":"Data di fine dell'intervallo (compresa).","disabled":true},{"key":"sort","value":"-created_at","description":"- created_at (impostazione predefinita, dal più recente al più vecchio) oppure created_at (dal più vecchio al più recente).","disabled":true},{"key":"page","value":"1","description":"Numero di pagina.","disabled":true}]},"description":"Restituisce gli ordini della tua organizzazione, in ordine cronologico (dal più recente al più vecchio), con impaginazione in `meta`. Tutti i parametri di query sono facoltativi.\n\nAmbito: `orders:read`"},"response":[]},{"name":"Approvare un ordine","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}/approve","host":["{{baseUrl}}"],"path":["orders","{{orderId}}","approve"]},"description":"Approva l'importo totale calcolato per un ordine che si trova nello stato `awaiting_approval`, attivandone l'evasione. Necessario solo quando il tuo account richiede l'approvazione prima dell'inizio dell'elaborazione. La chiamata è idempotente.\n\nSe l’ordine non è in attesa di approvazione, viene restituito il codice di errore 409 not_awaiting_approval; se è richiesto un addebito ma questo non va a buon fine, viene restituito il codice di errore 402 payment_failed o 402 credit_hold.\n\nAmbito: `orders:write`"},"response":[]}]}]}