{"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 de base de l'API. À redéfinir par environnement si nécessaire."},{"key":"apiKey","value":"YOUR_API_KEY","type":"string","description":"Votre clé API secrète, accessible depuis « Paramètres de l'entreprise » → « Clés API ». Utilisez une clé « Sandbox » pour le mode test."},{"key":"orderId","value":"","type":"string","description":"UUID d'une commande de traduction (l'`id` renvoyé par la fonction « Créer une commande »). Utilisé par les fonctions « Récupérer » et « Valider »."}],"item":[{"name":"Données de référence","description":"Consultez la liste des langues et la grille tarifaire. Ces informations doivent être renseignées dans les champs que vous envoyez lors de la création d'une commande.","item":[{"name":"Liste des langues","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/languages","host":["{{baseUrl}}"],"path":["languages"]},"description":"Renvoie toutes les langues prises en charge. Utilisez la valeur `name` telle quelle comme `source_language` / `target_language` lors de la création d'une commande — les commandes sont mises en correspondance en fonction du nom de la langue, et non du code.\n\nNécessite une clé authentifiée."},"response":[]},{"name":"Consulter la liste des prix","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/prices","host":["{{baseUrl}}"],"path":["prices"]},"description":"Renvoie la grille tarifaire de référence américaine, en USD, sur laquelle sont facturées vos commandes. Les montants sont des chaînes de caractères décimales. Les prix sont regroupés par type de « traduction » (chacun comportant un prix « standard » et un prix « urgent » par « unité »), par mode de « livraison » et par « apostille ».\n\nLa traduction assermentée est facturée par paire de langues — voir le bloc « language_pairs ».\n\nPortée : `price:read`"},"response":[]}]},{"name":"Commandes","description":"Créer, consulter, répertorier et valider des commandes de traduction.","item":[{"name":"Créer une commande","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"reference","value":"APO-10432","type":"text","description":"Votre référence de commande unique. Sa réutilisation renvoie la commande existante (idempotente)."},{"key":"customer[name]","value":"Jane Doe","type":"text","description":"Nom et prénom complets du client final."},{"key":"customer[email]","value":"jane@example.com","type":"text","description":"Adresse e-mail du client final."},{"key":"source_language","value":"Spanish","type":"text","description":"Nom exact de la langue figurant dans la liste des langues."},{"key":"target_language","value":"English (US)","type":"text","description":"Nom exact de la langue figurant dans la liste des langues."},{"key":"translation_type","value":"certified","type":"text","description":"Certifié, standard, spécialisé, assermenté, NAATI."},{"key":"turnaround","value":"regular","type":"text","description":"régulier ou rapide."},{"key":"delivery[method]","value":"email","type":"text","description":"L'un des éléments suivants : e-mail, e-mail certifié, courrier standard, courrier avec livraison le lendemain."},{"key":"delivery[address][street]","value":"","type":"text","description":"Obligatoire pour les options « mail_standard » et « mail_next_day ».","disabled":true},{"key":"delivery[address][city]","value":"","type":"text","disabled":true},{"key":"delivery[address][state]","value":"","type":"text","description":"Facultatif.","disabled":true},{"key":"delivery[address][postal_code]","value":"","type":"text","disabled":true},{"key":"delivery[address][country]","value":"US","type":"text","description":"Code pays ISO, par exemple US.","disabled":true},{"key":"apostille[enabled]","value":"false","type":"text","description":"Ajouter le traitement de l'apostille (la langue cible doit être l'anglais ; nécessite l'option « mail_standard »).","disabled":true},{"key":"apostille[documents]","value":"1","type":"text","description":"Nombre de documents à apostiller. Obligatoire lorsque cette option est activée.","disabled":true},{"key":"apostille[destination_country]","value":"","type":"text","description":"Pays pour lequel l'apostille est destinée.","disabled":true},{"key":"notes","value":"","type":"text","description":"Instructions sous forme de texte libre.","disabled":true},{"key":"coupon_code","value":"","type":"text","description":"Un code de réduction à utiliser.","disabled":true},{"key":"files[]","type":"file","src":[],"description":"1 à 20 fichiers. Formats autorisés : pdf, jpg, jpeg, png, doc, docx, tiff, heic. Taille maximale : 20 Mo par fichier."}]},"url":{"raw":"{{baseUrl}}/orders","host":["{{baseUrl}}"],"path":["orders"]},"description":"Crée une commande de traduction et télécharge les fichiers sources. Utilise `multipart/form-data` car ce format permet de transmettre des fichiers. Les champs imbriqués utilisent la notation entre crochets, par exemple `customer[name]`.\n\nJoignez au moins un fichier sous la clé `files[]` (sélectionnez un fichier dans la colonne « valeur »).\n\nUne commande nouvellement créée commence par le statut `pending` avec un total `null` pendant le calcul du prix. Interrogez la API pour récupérer une commande ou écoutez le webhook `order_status` pour voir la mise à jour du prix.\n\nIdempotence : répéter une création avec la même `reference` renvoie la commande existante avec le code 200 au lieu d’un doublon (une nouvelle commande renvoie le code 201).\n\nPortée : `orders:write`"},"response":[]},{"name":"Consulter une commande","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}","host":["{{baseUrl}}"],"path":["orders","{{orderId}}"]},"description":"Récupère une seule commande à l'aide de son `id` (l'UUID renvoyé lors de sa création). Définissez d'abord la variable de collection `orderId`. Renvoie le code d'erreur 404 « not_found » si la commande n'appartient pas à votre organisation.\n\nPortée : `orders:read`"},"response":[]},{"name":"Liste des commandes","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":"L'un des statuts suivants : « en attente », « en attente de validation », « en cours de traitement », « terminé », « annulé »."},{"key":"per_page","value":"50","description":"1–100. La valeur par défaut correspond au format de page standard."},{"key":"reference","value":"","description":"Triez les résultats selon votre référence.","disabled":true},{"key":"source_language","value":"","description":"Filtrer par nom de langue.","disabled":true},{"key":"target_language","value":"","description":"Filtrer par nom de langue.","disabled":true},{"key":"created_from","value":"","description":"Date de début de la plage (incluse).","disabled":true},{"key":"created_to","value":"","description":"Date de fin de la période (incluse).","disabled":true},{"key":"sort","value":"-created_at","description":"- created_at (par défaut, les plus récents en premier) ou created_at (les plus anciens en premier).","disabled":true},{"key":"page","value":"1","description":"Numéro de page.","disabled":true}]},"description":"Renvoie les commandes de votre organisation, classées par ordre chronologique (les plus récentes en premier), avec pagination dans `meta`. Tous les paramètres de requête sont facultatifs.\n\nPortée : `orders:read`"},"response":[]},{"name":"Approuver une commande","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"{{baseUrl}}/orders/{{orderId}}/approve","host":["{{baseUrl}}"],"path":["orders","{{orderId}}","approve"]},"description":"Valide le montant total calculé d’une commande dont le statut est « `awaiting_approval` », ce qui déclenche son exécution. Cette opération n’est nécessaire que si votre compte nécessite une validation avant le début du traitement. L’appel est idempotent.\n\nSi la commande n’est pas en attente d’approbation, vous obtenez le code d’erreur 409 « not_awaiting_approval » ; si un prélèvement est requis mais échoue, vous obtenez le code d’erreur 402 « payment_failed » ou 402 « credit_hold ».\n\nPortée : `orders:write`"},"response":[]}]}]}