Rapid Translate API

導入

のRapid Translate APIを利用することで、アプリケーションから認証翻訳の依頼文書を送信し、最新のステータスと料金を取得し、完了したファイルを受け取ることができます。お客様のチームが弊社の決済システムに触れる必要はありません。このAPIは、顧客に代わって翻訳を依頼する企業向けに設計されています。

すべてのリクエストは https://www.rapidtranslate.org/api/v1 HTTPS経由。リクエストとレスポンスはJSON形式ですが、注文作成ではファイルをアップロードします。 multipart/form-dataすべての金額は以下のように返されます 整数セント 金額は米ドル建てで、タイムスタンプはすべてUTC ISO-8601です。

郵便配達人コレクション

コードを書く前にAPIを実際に操作してみたいですか？Postmanコレクションには、認証情報、サンプルボディ、クエリパラメータなど、すべてのエンドポイントが事前に設定されています。

Postmanコレクションをダウンロード

1. Postmanで、 「ファイル」→「インポート」を選択し、ダウンロードしたファイルを選択します。
2. コレクションを開く 変数 そして設定する apiKey キーから ビジネス設定 → APIキー.
3. （オプション）設定 ベースURL お使いの環境に合わせて、デフォルトでは本番環境に設定されています。
4. リクエストを送信してください。サンドボックスキーを使用すると、課金対象となる注文を行わずにテストできます。

認証

すべてのリクエストを秘密のAPIキーをベアラートークンとして使用して認証し、JSONレスポンスを要求してください。以下の2つのヘッダーは必須です。

認証: Bearer YOUR_API_KEY 承認: application/json

ダッシュボードの「ビジネス設定」→「APIキー」でキーを生成およびローテーションできます。キーは作成時に一度表示され、ハッシュ化されて保存されます。キーを紛失した場合は、ローテーションしてください。各キーは1つのモード（ライブまたはサンドボックス）に属し、固定されたスコープセットを持ちます。

スコープ

各エンドポイントには、キーに対する特定の権限が必要です。必要なスコープを持たないキーは、 403 禁止範囲.

サンドボックスとテストモード

テストモードはアカウントではなく、キーの特性です。サンドボックスキーは完全にシミュレートされた環境で実行され、ライブキーは実際の課金対象となる注文を行います。両方を同時に使用することも可能です。

サンドボックス注文では、同じ検証、フィールドマッピング、実際の価格設定が使用されますが、ファイルストレージ、OCR、およびフルフィルメントはスキップされます。作成時に、サンドボックス注文は自動的にライフサイクルをたどります（処理中 → 完了) 実際の注文と同じウェブフックを発火させ、最終的に静的なサンプルドキュメントを配信します。

すべてのレスポンスとウェブフックには ライブモード フラグを設定することで、キーを検査せずに統合処理を分岐させることができます。

• ライブモード: true — 実際の請求対象注文
• ライブモード: false — サンドボックス／テスト注文

レート制限

リクエストは組織ごとにレート制限されています。デフォルトの許容値は 1分あたり120件のリクエストそれを超過すると 429 レート制限; 少し待ってから再試行します。統合でより高い制限が必要な場合は、お問い合わせください。 support@rapidtranslate.org.

回答

すべての成功した応答はペイロードを データ キー。エンドポイントのリストを追加します メタ ページネーション付きのブロック。

単一リソース

{
  "data": {
    "id": "9b1c...-uuid",
    "reference": "APO-10432",
    "status": "processing",
    "total": 11270,
    "currency": "USD"
  }
}

ページ分けされたリスト

{
  "data": [ ... ],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "total": 134,
    "last_page": 6
  }
}

エラー

エラーは標準の HTTP ステータス コードを使用し、安定した機械可読な値を返します。 エラーコード 人間のメッセージと並んで。検証エラーはフィールドキーを追加します エラー 物体。

{
  "message": "The given data was invalid.",
  "error_code": "validation_failed",
  "errors": {
    "source_language": ["The selected source language is invalid."]
  }
}

注文状況

注文の 状態 安定したライフサイクルに従います。これらの 5 つの価値観は、 状態 フィルター リスト注文:

注文処理中は、より詳細なラベル（例： 翻訳者に割り当てられました, 翻訳, 発送済み）も表示されることがあります。承認が必要な場合、命令書には簡潔に報告されることがあります。 支払い失敗 または クレジット保留 料金の徴収ができなかった場合は、支払い方法を見直して再度承認してください。

フィールド値

注文作成時に受け入れられる固定セット。

翻訳の種類

振り向く

配送方法

ウェブフック

ポーリングの代わりに、イベントが発生した時点で受信するWebhookエンドポイントを設定してください。URLを設定し、署名シークレットを確認するには、 「ビジネス設定」→「Webhook」をご覧ください。Webhookは便利な機能ですが、注文の取得は常に正式なものです。

イベント

封筒

すべての配達物には同じ封筒が入っています。 イベント ブロック（含む） ライブモード）そしてイベント固有の データ ブロック。

{
  "event": {
    "type": "order_status",
    "id": "evt_9b1c...",
    "livemode": true,
    "sent_at": "2026-08-28T10:20:00+00:00"
  },
  "data": {
    "order": {
      "id": "9b1c2d3e-...-uuid",
      "reference": "APO-10432",
      "status": "completed"
    }
  }
}

の 文書配達 イベントは 文書 配列（それぞれ 名前, ダウンロードURL, バージョン, 状態）そして ポータル リンク。 クライアントレビュー イベントは項目を追加します 価格設定 ブロックと アクションを承認する 呼び出し先のURLを含むオブジェクト。

署名の検証

各リクエストには署名が付いているので、誰から来たのか確認できますRapid Translate 3つのヘッダーを送信します。

文字列のHMAC-SHA256として期待される署名を計算します。 "{timestamp}.{raw_request_body}" ウェブフックの署名シークレットを使用して、ヘッダー値と比較します。

// PHP
$expected = 'sha256=' . hash_hmac(
    'sha256',
    $timestamp . '.' . $rawBody,
    $webhookSecret
);
$valid = hash_equals($expected, $signatureHeader);

Node.js (Express) — 生のボディパーサーを使用してルートをマウントし、正確なバイト列を保持します。

// app.use('/webhooks/rapidtranslate', express.raw({ type: 'application/json' }))
const crypto = require('crypto');

const timestamp = req.get('X-RapidTranslate-Timestamp');
const received  = req.get('X-RapidTranslate-Signature'); // "sha256=..."
const rawBody   = req.body;                               // Buffer, untouched

const expected = 'sha256=' + crypto
  .createHmac('sha256', WEBHOOK_SECRET)
  .update(`${timestamp}.${rawBody}`)
  .digest('hex');

const valid = received &&
  crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));

人々がつまずく3つのこと：

• の X-RapidTranslate-Signature ヘッダーは sha256= 接頭辞。比較対象 'sha256=' + yourHmac （上記のように）または比較する前にプレフィックスを削除します。むき出しの16進数をヘッダー全体と比較しないでください。
• 受信したリクエスト本文をそのままハッシュ化してください。解析済みのJSONを再シリアル化すると、空白文字やキーの順序が変わってしまうため、署名が一致しなくなります。JSONミドルウェアが解析する前に、リクエスト本文を読み取ってください。
• 定数時間で比較する（ハッシュイコール / 暗号タイミング安全等) 決して == または ===.

の {タイムスタンプ} これは署名付き文字列の一部なので、ヘッダーから読み取ってハッシュ化の前に追加します。また、古い配信や再配信された配信（例えば、5分以上前のタイムスタンプを持つ配信）を拒否することもできます。

失敗した配信は指数バックオフ（最大5回）で再試行されます。 2xx 受領確認のステータス。