احصل على تقارير تفصيلية عن استخدام واجهة برمجة التطبيقات (API) باستخدام معلمة "عرض الأحرف المفوترة" من DeepL
النقاط الرئيسية
- يمكن لمستخدمي DeepL API الإبلاغ عن عدد الأحرف التي يتم احتسابها لكل طلب ناجح لواجهة برمجة التطبيقات.
- يتيح معلمة show_billed_characters للمستخدمين الوصول الفوري إلى بيانات استخدام واجهة برمجة التطبيقات (API) مباشرةً في استجابة واجهة برمجة التطبيقات (API).
- يمكن استخدام بيانات الاستخدام لكل طلب في التقارير المخصصة وسير عمل تتبع التكاليف مباشرةً من API.
- وهذا مفيد بشكل خاص للمحتوى المنظم مثل HTML أو XML، حيث قد يكون من الصعب تحديد الأحرف القابلة للترجمة.
- توسع هذه الميزة نطاق تقارير/بلاغات واجهة برمجة تطبيقات DeepL API إلى ما وراء نقطة النهاية /usage وتساعدك على مراقبة نشاط الترجمة بدقة أكبر.
- المعلمة الجديدة show_billed_characters متاحة بالفعل لجميع عملاء DeepL API دون الحاجة إلى إعدادات إضافية.
لطالما وضع DeepL API التقارير والتحليلات كأولوية للمطورين والشركات مثل شركتك. وينطبق هذا سواء كان ذلك من خلال نقطة النهاية /usage مباشرةً في واجهة برمجة التطبيقات نفسها أو من خلال وظيفة الإبلاغ لـ مفاتيح API متعددة.
أصدر فريقنا هذه الإضافة المريحة إلى قائمتنا المتنامية من أدوات إعداد التقارير: أصبحت show_billed_characters متاحة الآن لجميع عملاء واجهة برمجة التطبيقات.
وهذا يضيف إلى وظائف إعداد التقارير المتنامية لـ DeepL API. وهي تتيح الآن عرضًا تفصيليًا لعدد الأحرف التي يتم احتسابها في بيانات الاستجابة لكل طلب API.
ما هو المعامل show_billed_characters؟
في السابق، كان لدى مستخدمي واجهة برمجة التطبيقات (API) الراغبين في الحصول على بيانات استخدام دقيقة مباشرةً من DeepL API خيار واحد فقط لاستدعاء نقطة النهاية /usage. هذه طريقة فعالة لاسترداد أحدث استخدام للأحرف لفترة الفَوتَرة الحالية. ومع ذلك، فإنها لا تقدم تفصيلاً دقيقاً للأحرف التي تتم ترجمتها في كل طلب.
يحل معلمة اختيارية هذه المشكلة من خلال إرجاع عدد الأحرف المترجمة والمفوترة مع استجابة كل طلب API ناجح.
اكتشف تقارير مرنة على مستوى المفتاح لمستخدمي DeepL API.
كيف تعمل المعلمة show_billed_characters؟
يمكن لعملاء واجهة برمجة التطبيقات (API) الذين يقدمون طلبات مباشرة إلى واجهة برمجة التطبيقات (API)، مثل عبر أمر cURL، إضافة المعلمة الجديدة show_billed_characters إلى طلباتهم. يُرجع هذا عدد الأحرف التي تمت فوترتها كجزء من بيانات الاستجابة.
ستُرجع استجابات واجهة برمجة التطبيقات (API) التي تنطوي على تكلفة الأحرف قيمة عددية جديدة بتنسيق "billed_characters:50" مع كل استجابة.
يمكنك تتبع هذه القيمة من جانب مستخدم واجهة برمجة التطبيقات (API) لاستخدامها في سير عمل الإبلاغ ولتتبع تكلفة كل طلب API فردي/مخصص للأفراد.
وهذا مهم بشكل خاص للطلبات التي تحتوي على محتوى منظم مثل HTML أو XML، حيث قد يكون من الصعب تحديد الأحرف القابلة للترجمة.
في المستقبل، يعتزم فريق DeepL تضمين billed_characters في استجابة API بشكل افتراضي. عندها، سيكون من الضروري إعداد/ضبط show_billed_characters على "false" لعدم تضمين "billed_characters" في استجابة API.
تعرف على كيفية تعزيز DeepL للأمان باستخدام مفاتيح API متعددة.
كيف يبدو رد API مع show_billed_characters
حاليًا، تحصل على استجابة مشابهة لهذه عند إرسال طلب إلى API:
سيبدو ردك هكذا إذا أرسلت طلبًا باستخدام المعلمة الجديدة show_billed_characters:
اطلع على التحولات الستة في مجال الترجمة التي يجب على الشركات العالمية اغتنامها الآن.
لماذا أضافت DeepL تقارير الأحرف المفوترة لكل طلب
طلب عدد من العملاء هذه الأداة. تتيح لك هذه الأداة الإبلاغ عن فوترة الأحرف بطريقة دقيقة ودمج تلك البيانات مباشرةً في أدوات إعداد التقارير الخاصة بك مع كل طلب ترجمة ناجح عبر واجهة برمجة التطبيقات (API).
المعلمة show_billed_characters تعمل بشكل كامل ضمن API DeepL لمستخدمي DeepL — ولا تتطلب أي إعدادات إضافية.
بالإضافة إلى ذلك، قمنا بتحديث وثائق API لتعكس هذا التغيير، مما يسهل على المطورين مثلك دمجها في سير عملك والبدء في الاستفادة من دقة ترجمة أعلى.
لمزيد من المعلومات، اقرأ أوصاف نص الطلب وملاحظات الإصدار.
طلب عدد من العملاء هذه الأداة، التي تمكنهم من الإبلاغ عن فوترة الأحرف بطريقة تفصيلية تتكامل أيضًا بشكل مباشر مع أدوات إعداد التقارير الخاصة بهم مع كل طلب ترجمة ناجح عبر واجهة برمجة التطبيقات (API).
المعلمة show_billed_characters تعمل بشكل كامل داخل واجهة برمجة التطبيقات (API) لمستخدمينا — ولا يتطلب الأمر أي إعدادات إضافية. بالإضافة إلى ذلك، تم تحديث وثائق API الخاصة بنا لتعكس هذا التغيير، مما يسهل على المطورين دمجها في سير عملهم والبدء في الاستفادة من دقة الترجمة المحسّنة.
الملحق/المراجع