POST/api/public/widget/voice-speak
แปลงข้อความเป็นเสียงพูด (Text-to-Speech) สำหรับการออกเสียงในวิดเจ็ต หากเปิดใช้งาน
การยืนยันตัวตนและความปลอดภัย
Widget-Embed-Token (Header X-Widget-Token) + รายการ Origin ที่อนุญาต
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ใช่
พารามิเตอร์
widget_code(body, string, จำเป็น)text(body, string, จำเป็น)— ข้อความที่จะแปลงเป็นเสียงพูดตัวอย่างการตอบกลับ
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"ฟังก์ชันเสียงพูดไม่พร้อมใช้งานในขณะนี้"}}รหัสข้อผิดพลาด
400 WIDGET_CODE_REQUIRED — widget_code หายไป503 VOICE_UNAVAILABLE — ฟังก์ชันเสียงไม่ได้เปิดใช้งานสำหรับวิดเจ็ตนี้หลักฐานการทดสอบแบบสด
ตรวจสอบสดแล้วกรณีล้มเหลว (400, 503) สำหรับ POST มีรูปแบบ GET ของเส้นทางเดียวกันนี้เช่นกัน (พฤติกรรมเหมือนกันตามการสกัดอัตโนมัติ) ไม่ได้ทดสอบซ้ำแยกต่างหาก