أسماء الحقول ورموز الأخطاء وأمثلة الشيفرة بالإنجليزية، كما تستخدمها في برنامجك.
الاستطلاعات
اطرح سؤالًا على الحاضرين من خادمك واقرأ النتائج أولًا بأول.
يظهر الاستطلاع لكل الحاضرين فورًا — وفي واجهة اجتماع ديوان يجيب المشارك بنقرة واحدة. يمكن لخادمك إنشاء الاستطلاعات وقراءة النتائج وإغلاقها وحذفها.
إنشاء استطلاع
ts
const poll = await deewan.polls.create(roomId, {
question: "Which topic should we cover next week?",
options: ["Kinematics", "Newton's laws", "Energy"],
kind: "single", // or "multiple"
anonymous: false, // true: nobody sees who picked what
results: "after_close", // "live" | "after_vote" | "after_close"
});curl
curl https://deewan.io/api/v1/rooms/$ROOM_ID/polls \
-H "Authorization: Bearer $DEEWAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"Ready to move on?","options":["Yes","Not yet"]}'قراءة النتائج
ts
const { data } = await deewan.polls.list(roomId);
for (const poll of data) {
console.log(poll.question, poll.status, poll.total_voters);
for (const option of poll.options) console.log(" ", option.label, option.votes);
}
await deewan.polls.close(poll.id); // reveals "after_close" results
await deewan.polls.delete(poll.id); // removes it for everyoneلكل شخص صوت واحد يمكنه تغييره حتى يُغلق الاستطلاع. والاستطلاعات المجهولة لا تُخزَّن فيها الأسماء إطلاقًا — لا للمضيفين ولا للواجهة البرمجية.
الأحداث
اشترك في poll.created وpoll.closed لنسخ الاستطلاعات إلى منتجك، مثلًا لحفظ إجابات الصف مع درسه.