تجاوز إلى المحتوى الرئيسي

الغرض من التطبيق

الغرض من تطبيق KiwiBee

ملخص بلغة واضحة لواجهات برمجة التطبيقات (API) الخاصة بالجهات الخارجية التي نستخدمها، والبيانات التي تنتقل في كل اتجاه، وكيف يمكن للمعلمين التحكم فيها أو إلغاء الاشتراك.

آخر تحديث: 2026-09-25

تُعدّ KiwiBee منصة مجانية لموارد المعلمين. وللحفاظ على مجانية أوراق العمل وأدوات الصف ومولّدات الذكاء الاصطناعي، نستخدم عددًا قليلًا من واجهات برمجة التطبيقات الخاصة بجهات خارجية لتوزيع المحتوى والمدفوعات والبريد الإلكتروني. توثّق هذه الصفحة كل تكامل بالتفصيل حتى يتمكن شركاء المنصات (Pinterest وStripe وGoogle وResend وSupabase) ومستخدمونا من التحقق مما نرسله ونستقبله.

Pinterest API

نستخدم Pinterest API (الإصدار 5) لنشر دبابيس أوراق العمل المجانية تلقائيًا على لوحات Pinterest المملوكة لـ KiwiBee، حتى يتمكن المعلمون من اكتشاف مواردنا مباشرةً من بحث Pinterest.

البيانات التي نرسلها

  • عنوان ورقة العمل (مثل «الجمع ضمن 20 — الصف 1»)
  • وصف ورقة العمل (ملخص قصير كتبه المسؤول عند الرفع)
  • رابط صورة المعاينة (مستضافة علنًا على شبكة CDN الخاصة بـ Supabase Storage لدينا)
  • رابط الوجهة المؤدي إلى صفحة تفاصيل ورقة العمل على kiwibee.io
  • وسوم المادة والصف، وتُستخدم فقط لاختيار اللوحة المناسبة

البيانات التي نستقبلها

  • معرّف الدبوس ومعرّف اللوحة، ويُخزَّنان فقط لنتمكن من تدقيق ما نشرناه
  • ترويسات حدود معدل الطلبات في API (قياسية)

الأثر على المعلمين

لا يربط المعلمون حساباتهم الخاصة على Pinterest بـ KiwiBee. يعمل التكامل على لوحات Pinterest المملوكة لـ KiwiBee فقط — فلا وصول إلى Pinterest على مستوى المستخدم، ولا قراءة للملفات الشخصية، ولا قوائم متابعين، ولا انتحال للهوية.

إلغاء الاشتراك

لا تُثبَّت أوراق العمل التي يرفعها مسؤولو KiwiBee على Pinterest إلا إذا اختار أحد المسؤولين ذلك. ولا تُثبَّت الموارد التي يرفعها المجتمع تلقائيًا أبدًا. وإذا أردت إزالة ورقة عمل معيّنة من KiwiBee عن Pinterest، فراسلنا عبر hello@kiwibee.io وسنحذف الدبوس خلال 7 أيام.

نطاقات OAuth: نطاقات OAuth المطلوبة: pins:read وpins:write وboards:read. ولا نطلب user_accounts:read أو user_followers:read أو أي نطاقات للوحات الخاصة.

Stripe API

نستخدم Stripe API لمعالجة الترقية الاختيارية إلى باقة Standard أو Premium، والتي تُفوتَر لكل طالب مرخَّص بسعر KiwiBee المعلن لكل طالب، بحد أدنى 30 طالبًا. تخزّن Stripe معلومات الدفع وتعالجها، ولا تطّلع KiwiBee أبدًا على بيانات البطاقة الأصلية.

البيانات التي نرسلها

  • عنوان البريد الإلكتروني للمعلم (لربطه بسجل العميل في Stripe)
  • معرّف باقة الاشتراك في KiwiBee (Standard أو Premium)، والسعر لكل طالب، وعدد الطلاب المرخَّصين المختار
  • معرّف عميل صادر عن Stripe، ويُخزَّن في ملف المعلم على KiwiBee

البيانات التي نستقبلها

  • حالة الاشتراك (active أو past_due أو canceled)
  • أحداث Webhook عند تغيّر الحالة
  • الإيصالات والفواتير، وترسلها Stripe مباشرةً إلى المعلم

الأثر على المعلمين

تمتثل Stripe لمعيار PCI-DSS وتتولى جميع بيانات الدفع الحساسة. ولا تطّلع KiwiBee أبدًا على أرقام البطاقات أو رموز CVC أو التفاصيل المصرفية ولا تخزّنها. ويدير المعلمون اشتراكهم (تحديث البطاقة، الإلغاء) بالكامل داخل بوابة العملاء في Stripe.

Google OAuth (مزوّد المصادقة في Supabase Auth)

إذا اختار المعلم «تسجيل الدخول باستخدام Google» بدلًا من الرابط السحري عبر البريد الإلكتروني، فإننا نستخدم Google OAuth عبر Supabase Auth للتحقق من هويته.

البيانات التي نرسلها

  • طلب تحقق OAuth قياسي (دون أي بيانات لمستخدمي KiwiBee)

البيانات التي نستقبلها

  • البريد الإلكتروني لحساب Google + الاسم المعروض + رابط الصورة الرمزية
  • معرّف مستخدم ثابت في Google، ويُستخدم فقط للتعرّف على المعلم في زياراته اللاحقة

الأثر على المعلمين

لا نستقبل أبدًا جهات الاتصال أو التقاويم أو محتوى Drive أو أي بيانات أخرى من Google — بل ملف OpenID الأساسي فقط. وتسجيل الدخول باستخدام Google اختياري؛ إذ لا يحتاج مسار الرابط السحري عبر البريد الإلكتروني إلى أي بيانات من Google.

Resend API (البريد الإلكتروني الخاص بالمعاملات)

نستخدم Resend لإيصال رسائل البريد الإلكتروني الخاصة بالمعاملات: رموز تسجيل الدخول عبر الرابط السحري، وتأكيدات الحساب، وإيصالات الدفع، وإشعارات الاشتراك. وتعمل Resend بوصفها خادم ترحيل SMTP لدينا.

البيانات التي نرسلها

  • عنوان البريد الإلكتروني للمستلم
  • موضوع الرسالة ونصها (نص عادي وHTML)

البيانات التي نستقبلها

  • حالة التسليم (أُرسلت، ارتدّت، فُتحت — عند تفعيل التتبع)

الأثر على المعلمين

لا تعالج Resend إلا محتوى الرسائل التي نرسلها، ولا تعالج أبدًا البريد الوارد أو دفاتر العناوين. ويمكن للمعلمين إلغاء الاشتراك في أي رسالة تسويقية؛ أما رسائل تسجيل الدخول والفوترة الخاصة بالمعاملات فلا تُرسل إلا استجابةً لإجراءاتهم.

Supabase (المصادقة والتخزين وقاعدة البيانات)

تستضيف Supabase حسابات المعلمين لدينا وتنزيلات أوراق العمل وسجل عمليات الإنشاء بالذكاء الاصطناعي. وتُحفظ جميع البيانات في مشروع Supabase مخصّص لنا.

البيانات التي نرسلها

  • ملف المعلم (البريد الإلكتروني، البلد، الصفوف التي يدرّسها، المواد)
  • سجلات التنزيل (معرّف ورقة العمل، والطابع الزمني) لتطبيق حدود الاستخدام
  • سجلات الإنشاء بالذكاء الاصطناعي (الطلبات التي تكتبها والمخرجات التي تُنشئها)

الأثر على المعلمين

يمكن للمعلمين طلب تصدير جميع بياناتهم أو حذفها عبر hello@kiwibee.io. ويؤدي حذف الحساب إلى حذف جميع التنزيلات وعمليات الإنشاء بالذكاء الاصطناعي وسجلات الملف الشخصي المرتبطة به.

الأسئلة أو طلبات البيانات

إذا كان لديك أي سؤال عن كيفية استخدامنا لواجهات برمجة التطبيقات هذه، أو أردت طلب الوصول إلى بياناتك أو تصديرها أو تصحيحها أو حذفها، فتواصل معنا عبر hello@kiwibee.io.