{"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":"주문에 적용되는 미국 기준 요금표(USD)를 반환합니다. 금액은 소수점 문자열로 표시됩니다. 가격은 `번역` 유형(각 유형마다 `단위`당 `일반` 및 `신속` 가격이 있음), `배송` 방법, `아포스티유`별로 그룹화되어 있습니다.\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":"공인, 표준, 전문, 선서, 나티 중 하나."},{"key":"turnaround","value":"regular","type":"text","description":"일반 또는 급행."},{"key":"delivery[method]","value":"email","type":"text","description":"이메일, 공증된 이메일, 일반 우편, 익일 배송 중 하나."},{"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. 각 파일당 최대 20MB."}]},"url":{"raw":"{{baseUrl}}/orders","host":["{{baseUrl}}"],"path":["orders"]},"description":"번역 주문을 생성하고 원본 파일을 업로드합니다. 파일을 전송하기 위해 `multipart/form-data`를 사용합니다. 중첩된 필드는 대괄호 표기법(예: `customer[name]`)을 사용합니다.\n\n`files[]` 키 아래에 파일을 하나 이상 첨부하십시오(값 열에서 파일을 선택).\n\n새로 생성된 주문은 가격 계산이 진행되는 동안 `pending` 상태로 시작되며 총액은 `null`입니다. 폴링하여 주문을 조회하거나 `order_status` 웹훅을 수신하여 가격 업데이트를 확인하세요.\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)를 기준으로 단일 주문을 가져옵니다. 먼저 `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":[]}]}]}