المطورون / الوكلاء

إنشاء تذكرة لويدجت موقع خاص

POST https://api.echonova.ai/v1/widgets/{publicId}/tickets

استدعِ هذه النقطة من خادمك لزائر مسجّل الدخول. تعيد تذكرة تُستخدم مرة واحدة، تمرّرها إلى متصفح الزائر، فيبدأ بها جلسة واحدة في الويدجت. يجب أن يكون الويدجت خاصًا ومفعّلًا. إنشاء التذكرة مجاني.

Headers

Authorization string مطلوب

كلمة ⁦Bearer⁩ ثم مسافة ثم مفتاح ⁦API⁩ الذي يبدأ بـ ⁦ek_⁩. أنشئ المفاتيح في البوابة من المطورون، ثم مفاتيح واجهة برمجة التطبيقات.

معاملات المسار

publicId string مطلوب

معرّف الويدجت من إعدادات الويدجت، ويبدأ بـ `wdg_`.

متن الطلب

application/json

user object اختياري

الزائر المسجّل الدخول الذي أُنشئت له هذه التذكرة.

channel string اختياري

يقصر التذكرة على قناة واحدة. احذفه للسماح بالقناتين.

voice أو chat
ttlSeconds integer اختياري

عدد الثواني التي تبقى فيها التذكرة صالحة، من 60 إلى 900. تعمل مرة واحدة فقط.

من 60 إلى 900الافتراضي 300

الاستجابة

200 application/json كل استجابة تستخدم هذا الغلاف.

data object

النتيجة.

success boolean

قيمته ⁦true⁩ عند نجاح الطلب.

statusCode integer

يكرر رمز حالة ⁦HTTP⁩.

errorMessage string or null

قيمته ⁦null⁩ عند النجاح.

الأخطاء

الغلاف نفسه، مع ⁦success⁩ بقيمة ⁦false⁩ و ⁦data⁩ بقيمة ⁦null⁩. كل الأخطاء

POST /v1/widgets/{publicId}/tickets

curl -X POST "https://api.echonova.ai/v1/widgets/wdg_a1B2c3D4e5F6g7H8i9J0/tickets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "ticket": "wtk_IlrI02c2RnE7iqidinRQanxpcTovunoAK7Bu5R6Zc5w",
    "expiresAt": "2026-10-19T09:30:00.000Z"
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}