Rapid Translate API

소개

그만큼 Rapid Translate API를 사용하면 애플리케이션에서 공증 번역을 위한 문서를 제출하고, 최신 상태 및 가격을 조회하고, 최종 번역 파일을 받을 수 있습니다. 이 모든 과정에서 팀에서 당사의 결제 시스템을 건드릴 필요가 없습니다. 이 API는 고객을 대신하여 번역 주문을 처리하는 기업을 위해 설계되었습니다.

모든 요청은 다음으로 이루어집니다. https://www.rapidtranslate.org/api/v1 HTTPS를 통해 전송됩니다. 요청 및 응답은 JSON 형식이며, 주문 생성 시에는 파일을 업로드합니다. 멀티파트/폼 데이터모든 금액은 다음과 같이 반환됩니다. 정수 센트 모든 금액은 미국 달러이며, 타임스탬프는 UTC ISO-8601 기준입니다.

포스트맨 컬렉션

코드를 작성하기 전에 API를 직접 사용해 보고 싶으신가요? 저희 Postman 컬렉션에는 인증, 예시 본문, 쿼리 매개변수 등 모든 엔드포인트가 미리 구성되어 있습니다.

Postman 컬렉션을 다운로드하세요

1. Postman에서 파일 → 가져오기를 선택하고 다운로드한 파일을 선택합니다.
2. 컬렉션을 열어보세요 변수 그리고 설정 apiKey 키에서 비즈니스 설정 → API 키.
3. (선택 사항) 설정 baseUrl 사용 환경에 따라 기본값은 프로덕션으로 설정됩니다.
4. 모든 요청을 보내세요. 샌드박스 키를 사용하여 유료 주문 없이 테스트할 수 있습니다.

입증

모든 요청을 비밀 API 키를 베어러 토큰으로 사용하여 인증하고 JSON 응답을 요청하세요. 두 헤더 모두 필수입니다.

인증: Bearer YOUR_API_KEY 수락: application/json

대시보드의 비즈니스 설정 → API 키 에서 키를 생성하고 교체할 수 있습니다. 키는 생성 시 한 번만 표시되며 해시된 상태로 저장됩니다. 키를 분실한 경우 새 키로 교체하세요. 각 키는 하나의 모드 (라이브 또는 샌드박스)에 속하며 고정된 범위 집합을 가집니다.

스코프

각 엔드포인트는 키에 특정 권한을 요구합니다. 필요한 범위가 없는 키는 오류를 반환합니다. 403 forbidden_scope.

샌드박스 및 테스트 모드

테스트 모드는 계정 속성이 아니라 키 자체의 속성입니다. 샌드박스 키는 완벽하게 시뮬레이션된 환경에서 실행되고, 라이브 키는 실제 결제가 가능한 주문을 처리합니다. 두 가지 모두 동시에 사용할 수 있습니다.

샌드박스 주문은 실제 주문과 동일한 유효성 검사, 필드 매핑 및 가격 책정을 사용하지만 파일 저장, OCR 및 주문 처리 과정을 생략합니다. 샌드박스 주문은 생성 시 자동으로 전체 수명 주기를 거칩니다.처리 중 → 완료됨), 실제 주문과 동일한 웹훅을 실행하고 마지막으로 정적 샘플 문서를 제공합니다.

모든 응답과 웹훅에는 다음이 포함됩니다. 라이브모드 키를 검사하지 않고도 통합이 분기될 수 있도록 하는 플래그입니다.

• 라이브 모드: true — 실제 청구 가능한 주문
• 라이브 모드: false — 샌드박스/테스트 순서

요금 제한

조직별로 요청 횟수에 제한이 있습니다. 기본 허용량은 다음과 같습니다. 분당 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."]
  }
}

주문 상태

주문의 상태 안정적인 수명 주기를 따릅니다. 이 다섯 가지 값은 또한 일반적으로 받아들여지는 값입니다. 상태 필터 켜기 주문 목록:

주문이 진행되는 동안 더 세분화된 레이블(예: 번역가에게 배정됨, 번역하기, 배송됨)도 나타날 수 있습니다. 승인이 필요한 경우, 주문서에 간략하게 보고될 수 있습니다. 결제 실패 또는 신용보유 결제가 이루어지지 않은 경우, 결제 방법을 해결하고 다시 승인하십시오.

필드 값

주문 생성 시 허용되는 고정 세트입니다.

번역 유형

턴어라운드

배송 방법

웹훅

폴링 방식 대신 웹훅 엔드포인트를 구성하여 이벤트 발생 시 수신하세요. URL을 설정하고 서명 비밀 키는 비즈니스 설정 → 웹훅 에서 확인할 수 있습니다. 웹훅은 편리한 기능이며, 주문 조회는 항상 공식적인 결과를 제공합니다.

이벤트

봉투

모든 배송에는 동일한 봉투가 들어 있습니다: 이벤트 블록(포함) 라이브모드) 및 이벤트별 데이터 차단하다.

{
  "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, 버전, 상태) 그리고 a 문 링크. 고객 리뷰 이벤트는 항목별 목록을 추가합니다. 가격 블록과 액션.승인 호출할 URL이 담긴 객체입니다.

서명 확인

각 요청에는 서명이 되어 있으므로 누가 요청했는지 확인할 수 있습니다. Rapid Translate 우리는 세 개의 헤더를 보냅니다.

예상 서명을 해당 문자열의 HMAC-SHA256으로 계산합니다. "{타임스탬프}.{원시 요청 본문}" 웹훅 서명 비밀 키를 사용하여 헤더 값과 비교합니다.

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

Node.js(Express) — 정확한 바이트 수를 유지하기 위해 raw body 파서를 사용하여 경로를 마운트합니다.

// 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));

사람들이 흔히 실수하는 세 가지:

• 그만큼 X-RapidTranslate-Signature 헤더는 다음을 포함합니다 샤256= 접두사. 또는 ~와 비교하십시오. 'sha256=' + yourHmac (위와 같이) 비교하기 전에 접두사를 제거하세요. 16진수 값만 전체 헤더와 비교하지 마세요.
• 수신된 요청 본문을 있는 그대로 해시합니다. 파싱된 JSON을 다시 직렬화하면 공백과 키 순서가 바뀌므로 서명이 일치하지 않습니다. 따라서 JSON 미들웨어가 파싱하기 전에 본문을 읽어야 합니다.
• 일정한 시간 간격에서 비교하십시오.hash_equals / 크립토.타이밍세이프이퀄), 절대 ~와 함께 == 또는 ===.

그만큼 {타임스탬프} 서명된 문자열의 일부이므로 헤더에서 읽어 해싱하기 전에 앞에 추가해야 합니다. 또한 이를 통해 만료되었거나 재전송된 메시지(예: 5분보다 오래된 타임스탬프)를 거부할 수 있습니다.

전송 실패 시 지수적 백오프 방식으로 재시도합니다(최대 5회). 응답하려면 다음을 입력하십시오. 2xx 수신 확인을 위한 상태 메시지입니다.