الانتقال إلى المحتوى الرئيسي
الوظيفة الرئيسية لواجهة برمجة التطبيقات لترجمة التوطين هي الحصول على النص المترجم من خلال إدخال النص المطلوب ترجمته، كما يمكن تخصيص اللغة المترجم إليها، ويمكن أن تكون نتائج الترجمة بصيغتي 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:المحتوى المطلوب ترجمته. عند extension=md يتم تمرير سلسلة نصية، وعند extension=json يتم تمرير كائن JSON.
  • locale:تخصيص لغة الترجمة.
  • extension:تنسيق محتوى الإدخال، يمكن أن يكون md أو json.
  • model:النموذج الكبير المستخدم في الترجمة، الافتراضي هو gpt-3.5.
يجب أن يتطابق extension مع نوع input؛ لا يمكن استخدام السلسلة النصية مع json، ولا يمكن استخدام كائن JSON مع md. الإعداد كما هو موضح في الصورة أدناه:

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

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

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

CURL

Python

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

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

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

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

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

الخاتمة

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