Deewanالتوثيق

أسماء الحقول ورموز الأخطاء وأمثلة الشيفرة بالإنجليزية، كما تستخدمها في برنامجك.

الاستطلاعات

اطرح سؤالًا على الحاضرين من خادمك واقرأ النتائج أولًا بأول.

يظهر الاستطلاع لكل الحاضرين فورًا — وفي واجهة اجتماع ديوان يجيب المشارك بنقرة واحدة. يمكن لخادمك إنشاء الاستطلاعات وقراءة النتائج وإغلاقها وحذفها.

إنشاء استطلاع

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 لنسخ الاستطلاعات إلى منتجك، مثلًا لحفظ إجابات الصف مع درسه.