Skip to main content
الوظيفة الرئيسية لواجهة برمجة التطبيقات لترجمة التوطين هي الحصول على النص المترجم من خلال إدخال النص المطلوب ترجمته، كما يمكن تخصيص اللغة المترجم إليها، ويمكن أن تكون نتائج الترجمة بصيغتي json و markdown. ستتناول هذه الوثيقة بالتفصيل تعليمات توصيل واجهة برمجة التطبيقات، لمساعدتك على دمجها بسهولة والاستفادة الكاملة من قوة هذه الواجهة. من خلال واجهة برمجة التطبيقات للترجمة، يمكنك بسهولة ترجمة النص المدخل إلى لغة معينة، وتدعم طرق معينة لعرض نتائج الترجمة.

عملية التقديم

لاستخدام واجهة برمجة التطبيقات لترجمة التوطين، يجب أولاً الذهاب إلى وحدة التحكم في Ace Data Cloud للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية. إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم إرجاعك تلقائيًا إلى الصفحة الحالية. يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة. ستتلقى رصيدًا مجانيًا عند الطلب لأول مرة، يمكنك تجربته مجانًا؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في وحدة التحكم.
📘 الوثيقة الكاملة: واجهة برمجة التطبيقات لترجمة التوطين →

مثال على الطلب

سنأخذ مثالاً على إدخال باللغة الإنجليزية، لعرض كيفية استخدام هذه الواجهة. لنفترض أن الوصف باللغة الإنجليزية هو: # Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.، وسنوضح كيفية رفع الوصف باللغة الإنجليزية والحصول على نتيجة الترجمة إلى اللغة الصينية، مع عرضها بصيغة markdown.

إعداد رأس الطلب وجسم الطلب

رؤوس الطلب تشمل:
  • accept: تحديد استلام نتائج الاستجابة بصيغة JSON، هنا يتم ملؤها بـ application/json.
  • authorization: مفتاح استدعاء واجهة برمجة التطبيقات، يمكن اختياره مباشرة بعد التقديم.
جسم الطلب يشمل:
  • input: النص المطلوب ترجمته.
  • locale: اللغة المخصصة للترجمة.
  • extension: الشكل المخصص لعرض نتيجة الترجمة.
  • model: النموذج الكبير المستخدم في الترجمة، الافتراضي هو gpt-3.5.
الإعداد كما هو موضح في الصورة أدناه:

مثال على الكود

يمكنك ملاحظة أنه تم إنشاء أكواد بلغات مختلفة تلقائيًا على الجانب الأيمن، كما هو موضح في الصورة:

بعض أمثلة الكود كما يلي:

CURL

بايثون

مثال على الاستجابة

بعد نجاح الطلب، ستقوم واجهة برمجة التطبيقات بإرجاع معلومات نتيجة هذه المهمة الترجمة. على سبيل المثال:
يمكنك أن ترى أن النتيجة تحتوي على حقل data، الذي يحتوي على النص المترجم إلى الصينية، كما تم إرجاعه بصيغة markdown، والمعلومات الأخرى كما يلي:
  • data، نتيجة مهمة الترجمة هنا.
  • model، النموذج اللغوي الكبير المستخدم في مهمة الترجمة هنا.
  • locale، نوع لغة الترجمة لمهمة الترجمة هنا.

معالجة الأخطاء

عند استدعاء واجهة برمجة التطبيقات، إذا واجهت خطأ، ستقوم الواجهة بإرجاع رمز الخطأ والمعلومات المناسبة. على سبيل المثال:
  • 400 token_mismatched: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صحيحة.
  • 400 api_not_implemented: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صحيحة.
  • 401 invalid_token: غير مصرح، رمز التفويض غير صحيح أو مفقود.
  • 429 too_many_requests: عدد كبير جدًا من الطلبات، لقد تجاوزت الحد الأقصى لمعدل الطلبات.
  • 500 api_error: خطأ في الخادم الداخلي، حدث خطأ ما على الخادم.

مثال على استجابة الخطأ

الخاتمة

من خلال هذه الوثيقة، أصبحت على دراية بكيفية استخدام واجهة برمجة التطبيقات لترجمة التوطين بسهولة لترجمة النص المدخل إلى لغة معينة، وتدعم طرق معينة لعرض نتائج الترجمة. نأمل أن تساعدك هذه الوثيقة في توصيل واستخدام هذه الواجهة بشكل أفضل. إذا كان لديك أي استفسارات، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.