{"info":{"name":"واجهة برمجة تطبيقات RapidTranslate (الإصدار 1)","_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 الأساسي لواجهة برمجة التطبيقات (API). يمكن تغييره حسب كل بيئة إذا لزم الأمر."},{"key":"apiKey","value":"YOUR_API_KEY","type":"string","description":"مفتاح API السري الخاص بك من «إعدادات الأعمال» → «مفاتيح API». استخدم مفتاح «Sandbox» لوضع الاختبار."},{"key":"orderId","value":"","type":"string","description":"معرّف UUID لطلب الترجمة (القيمة `id` التي تُرجعها وظيفة «إنشاء طلب»). تُستخدم في وظيفتي «استرداد» و«الموافقة»."}],"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":"يعرض جدول الأسعار الأساسي للولايات المتحدة، بالدولار الأمريكي، الذي تُحسب عليه فواتير طلباتك. المبالغ عبارة عن سلاسل عشرية. يتم تجميع الأسعار حسب نوع «الترجمة» (كل منها بسعر «عادي» و«سريع» لكل «وحدة»)، وطريقة «التسليم»، و«الأبوستيل».\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":"إضافة خدمة توثيق الوثائق بالأبوستيل (يجب أن تكون اللغة المستهدفة هي الإنجليزية؛ ويتطلب استخدام خدمة البريد العادي).","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. الحد الأقصى لحجم كل ملف هو 20 ميغابايت."}]},"url":{"raw":"{{baseUrl}}/orders","host":["{{baseUrl}}"],"path":["orders"]},"description":"ينشئ طلب ترجمة ويقوم بتحميل الملفات المصدرية. يستخدم `multipart/form-data` لأنه ينقل الملفات. تستخدم الحقول المتداخلة صيغة الأقواس، على سبيل المثال `customer[name]`.\n\nأرفق ملفًا واحدًا على الأقل تحت المفتاح `files[]` (اختر ملفًا في عمود القيمة).\n\nيبدأ الطلب الذي تم إنشاؤه حديثًا بحالة «pending» (معلق) مع إجمالي «null» أثناء حساب السعر. قم بالاستعلام لاسترجاع الطلب أو استمع إلى webhook «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`، مما يؤدي إلى تفعيله للبدء في تنفيذه. لا يلزم استخدام هذه العملية إلا عندما يتطلب حسابك الحصول على موافقة قبل بدء العمل. هذه العملية متكررة (idempotent).\n\nإذا لم يكن الطلب في حالة «في انتظار الموافقة»، فستحصل على الرمز 409 not_awaiting_approval؛ وإذا كانت هناك حاجة إلى تحصيل رسوم ولكن العملية فشلت، فستحصل على الرمز 402 payment_failed أو 402 credit_hold.\n\nالنطاق: `orders:write`"},"response":[]}]}]}