POST/api/public/widget/voice-transcribe
يحوّل تسجيلاً صوتيًا منطوقًا من الزائر إلى نص (تحويل الكلام إلى نص)، إذا كانت ميزة الصوت مفعّلة لـ Widget.
المصادقة والأمان
رمز تضمين الودجت (ترويسة X-Widget-Token) + قائمة النطاقات المسموح بها
متطابق القوة: لا
المعلمات
widget_code(body, string، إلزامي)audio(body, binary، إلزامي)— بيانات صوتية للتفريغ النصي (transcription)مثال استجابة
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}رموز الأخطاء
400 WIDGET_CODE_REQUIRED — widget_code مفقود.503 VOICE_UNAVAILABLE — ميزة الصوت غير مفعّلة لهذا Widget.إثبات الاختبار المباشر
تم التحقق مباشرة من الحالات السلبية (400 حقل مفقود، 503 ميزة الصوت غير مفعّلة). أما حالة النجاح فتتطلب Widget صوتيًا مفعّلاً مع صوت حقيقي ومزوّد للتعرف على الكلام تم إعداده — لم تتم إعادة إنتاجها.