{"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":"API のベース URL。必要に応じて、環境ごとに上書きしてください。"},{"key":"apiKey","value":"YOUR_API_KEY","type":"string","description":"「ビジネス設定」→「APIキー」から、ご自身の秘密のAPIキーを確認してください。テストモードでは、サンドボックスキーを使用してください。"},{"key":"orderId","value":"","type":"string","description":"翻訳注文のUUID（`Create an order` によって返される `id`）。`Retrieve` および `Approve` で使用されます。"}],"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":"注文の請求基準となる、米ドル建ての米国基準料金表を返します。金額は小数文字列で表されます。価格は、`translation` タイプ（それぞれ `regular` および `rapid` の `unit` あたりの価格があります）、`delivery` 方法、および `apostille` ごとにグループ化されています。\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。1ファイルあたりの最大サイズは20 MBです。"}]},"url":{"raw":"{{baseUrl}}/orders","host":["{{baseUrl}}"],"path":["orders"]},"description":"翻訳オーダーを作成し、ソースファイルをアップロードします。ファイルを転送するため、`multipart/form-data` を使用します。ネストされたフィールドには角括弧表記を使用します（例：`customer[name]`）。\n\n`files[]` キーの下に、少なくとも 1 つのファイルを添付してください（値の列でファイルを選択してください）。\n\n新しく作成された注文は、価格計算が行われている間、`pending` ステータスで合計金額が `null` の状態から始まります。注文を取得するか、`order_status` Webhook を監視して価格の更新を確認してください。\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）を指定して、1件の注文を取得します。まず、`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":[]}]}]}