الأسئلة الشائعة حولListen API

1. لماذا أستخدم Listen API؟ ولماذا أفضّله على iTunes API؟ 🔗

لديك دائماً بدائل: إنشاء قاعدة بيانات بودكاست وصيانتها بنفسك، أو اختيار API أخرى على الإنترنت.

لمساعدتك على تقييم Listen API، نوفر تسعيراً واضحاً وبسيطاً وتوثيقاً شاملاً لجميع نقاط النهاية مع أمثلة لاستجابات JSON.

يمكنك تجربة Listen API بسهولة ومن دون التحدث إلى المبيعات أو طلب عرض توضيحي؛ ما عليك سوى الاشتراك في خطة FREE من دون إدخال بطاقة ائتمان.

إذا اشتركت في PRO أو ENTERPRISE، فراسل hello@listennotes.com لتحصل سريعاً على إجابة مباشرة من مؤسس Listen Notes ومديرها التنفيذي.

أما iTunes API من Apple، فننصح بقراءة توثيقها وتجربتها. قد لا تناسب احتياجاتك لأنها لا توفر ما يكفي من نقاط النهاية والبيانات المنظمة لبعض الميزات الأساسية، وتعيد نتائج بحث قليلة بترتيب غير مثالي، وقد تمنع شروطها بعض الاستخدامات، كما قد لا تحظى بصيانة نشطة أو دعم بشري سريع.

قد يفيدك هذا المقال: كيف تقيّم RESTful API من طرف ثالث؟

2. ما مدى صعوبة إنشاء قاعدة بيانات للبودكاست؟ 🔗

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

قبل إنشاء قاعدة بياناتك، تذكّر أن الإنترنت يضم ما لا يقل عن 3,831,088 برنامج بودكاست و196,732,836 حلقة، وأن العدد ينمو باستمرار. وعند هذا الحجم، تتغير موجزات RSS وعناوين الصوت كثيراً، فتحتاج إلى أدوات وعمليات بشرية تعمل على مدار الساعة لتنظيف البيانات. كما أن البحث بالكلمات المفتاحية في 3,831,088 برنامج و196,732,836 حلقة يتطلب إنشاء محرك بحث معقد. وهناك أيضاً برامج مزيفة وصوت مولّد آلياً يجب اكتشافه ومنعه، إضافة إلى تشغيل قاعدة البيانات ومحرك البحث بلا انقطاع. سيكلّفك ذلك رواتب مهندسين ووقتاً كان يمكن استثماره في منتجك.

استخدام Listen API يتيح لك بدء الجزء المهم من مشروعك فوراً. كما يدعم موقعنا، الذي يستخدمه أكثر من 2,000,000 شخص شهرياً، تحديث البيانات؛ فيرسل المستخدمون البرامج المفقودة ويصححون الأخطاء. وبمساعدتهم نحافظ على قاعدة عالية الجودة تضم 3,831,088 برنامج و196,732,836 حلقة، بدلاً من أن تضطر إلى بناء وصيانة نظام بهذا الحجم بنفسك.

3. هل تدعمون API بفاعلية؟ وهل تتوقعون مواصلة ذلك؟ 🔗

نعم لكلا السؤالين.

تدعم Listen API منتجاتنا، ولذلك نستخدمها بأنفسنا يومياً ونواصل صيانتها وتحسينها.

4. ماذا لو استخدمنا Listen API ثم توقفت الخدمة مستقبلاً؟ 🔗

مخاوفك مفهومة؛ فلا خدمة أو شركة تدوم إلى الأبد. لذلك نستخدم معايير مفتوحة ونوفر بيانات واضحة كي لا يكون الانتقال مستحيلاً.

Listen API جزء أساسي من منتجات Listen Notes ونستخدمها بأنفسنا يومياً، ولذلك لدينا حافز قوي لمواصلة تشغيلها وتحسينها. وإذا تغيّر شيء جوهري، فسنمنح العملاء وقتاً معقولاً وخيارات مناسبة للانتقال.

5. هل تقدمون دعماً؟ 🔗

نعم. إذا اشتركت في PRO أو ENTERPRISE، فأرسل رسالة إلى hello@listennotes.com وسنساعدك.

نجيب عادة خلال دقائق، وستتحدث مباشرة مع مؤسس Listen Notes ومديرها التنفيذي.

6. سنرسل عدداً هائلاً من طلبات API. هل يمكنكم دعم حجم استخدامنا؟ 🔗

تستخدم شركات حالياً Listen API لإرسال عشرات الملايين من الطلبات شهرياً. بنيتنا الأساسية قابلة للتوسع ويمكنها دعم حجم استخدامك.

تواصل معنا على hello@listennotes.com إذا كانت لديك متطلبات خاصة بالحجم أو الأداء.

7. هل يمكننا تخزين استجابة API مؤقتاً على جانب العميل، مثل داخل التطبيق أو المتصفح؟ 🔗

نعم. تسمح شروط استخدام API لخطتي FREE وPRO بالتخزين المؤقت للاستجابات على جانب العميل، مثل التطبيق أو المتصفح، لتحسين الأداء. لكن لا يجوز تخزين معظم قاعدة البيانات أو إعادة توزيعها من الخادم.

قد تتغير البيانات، لذا حدّث النسخة المؤقتة دورياً. تتيح خطة ENTERPRISE سياسة أكثر مرونة للتخزين على الخادم؛ تواصل معنا إذا احتجت إليها.

8. لماذا تأتي عناوين URL الصوتية في استجابة API من نطاق listennotes.com؟ 🔗

للتوضيح، لا نخزّن الملفات الصوتية على خوادمنا. يظل منشئو البودكاست قادرين على الحصول على تحليلات دقيقة، مثل عنوان IP وuser-agent للمستمع.

نغلّف عنوان الصوت الأصلي بعنوان من نطاقنا باستخدام إعادة توجيه HTTP 301، لأن عناوين الصوت تتغير كثيراً ونريد أن يبقى الرابط الذي تستخدمه صالحاً.

يمكن للتطبيق تخزين عنوان Listen Notes الدائم مؤقتاً، بينما نعثر نحن على عنوان الصوت الصحيح على الخادم ونواصل التحقق من أي تغييرات.

9. ماذا لو لم نجد بودكاست معيناً، أو لم تتزامن البيانات مع موجز RSS، مثل وجود صوت معطّل أو بيانات وصفية غير صحيحة؟ 🔗

رغم شمول قاعدة بياناتنا، قد لا نكتشف بعض البرامج الجديدة فوراً، كما تحتاج محركات البحث إلى وقت لاكتشاف المواقع. يمكنك عندها إرسال البرنامج المفقود.

وقد يغيّر منشئ البودكاست موجز RSS قبل أن نكتشفه، أو قد يتضمن الموجز خطأ. أرسل أخطاء البيانات الوصفية إلى hello@listennotes.com وسنصلحها سريعاً، أو استخدم أدوات الإصلاح الذاتية في تطبيقك للمساعدة على إبقاء البيانات صحيحة.

10. كيف تتأكدون من أن قاعدة بيانات البودكاست محدّثة؟ 🔗

نعثر على برامج بودكاست جديدة بأربع طرق:

نشغّل برامج زحف على مدار الساعة للعثور على البرامج العامة على الإنترنت.
يرسل منشئو البودكاست برامجهم الجديدة بأنفسهم، ونتلقى مئات الإرسالات يومياً.
يضيف موظفو Listen Notes البرامج المفقودة يدوياً. كما يستخدم موقع listennotes.com أكثر من 2,000,000 شخص شهرياً، ويمكنهم إرسال البرامج المفقودة. نراجع كل إرسال يدوياً ونرفض البرامج المزيفة، مثل الصوت المولّد آلياً.
نتعاون مع خدمات استضافة كبرى تتكامل مع Podcast API لإرسال البرامج مباشرة إلى Listen Notes.

نفحص موجز RSS لجميع البرامج باستمرار. تُضاف الحلقات الجديدة للبرامج المستخدمة حديثاً خلال ساعة، وعادة خلال 15 إلى 30 دقيقة؛ أما البرامج الأخرى فتُجلب حلقاتها خلال بضع ساعات، عادة من ساعتين إلى أربع.

11. ماذا يحدث إذا خالفنا شروط استخدام API؟ 🔗

سيُعلّق حسابك إذا خالفت شروط استخدام API. يمكنك الاعتراض عبر hello@listennotes.com.

أكثر أسباب التعليق شيوعاً: إنشاء حسابات متعددة للتحايل على حصة FREE، ولا سيما بعناوين بريد مؤقتة؛ أو تخزين معظم بيانات الاستجابة على الخادم. تأكد من الالتزام بشروط الاستخدام.

12. هل يجب عرض شعار Listen Notes في تطبيقنا حتى مع استخدام خطة مدفوعة؟ 🔗

نعم. تنطبق شروط استخدام API على جميع مستخدمي FREE وPRO. يكفي عرض عبارة "Powered by Listen Notes" على شاشة واحدة تستخدم بياناتنا، ويمكن وضع الشعار أسفل الجزء الظاهر أولاً كي لا يزعج المستخدمين.

لا نقدم استثناءات لمستخدمي FREE أو PRO، سواء كانوا مطوّرين أفراداً أو شركات عامة، لأن التخصيصات الفردية تزيد التعقيد التشغيلي وتستنزف وقت تطوير المنتج.

إظهار مصدر البيانات سياسة شائعة في خدمات API؛ فمثلاً تستخدم Uber خرائط Google وتعرض شعار Google في تطبيقها.

يمكننا التحلي بمرونة في متطلبات الشعار لمشتركي ENTERPRISE.

13. هل يمكننا مناقشة شراكتنا هاتفياً؟ 🔗

صُممت Listen API لتكون خدمة ذاتية. إذا لم يتضح خلال دقائق ما الذي تفعله وكيف تستخدمها، فهذا تقصير منا في الشرح. إذا كانت لديك أسئلة، فلنتحدث أولاً عبر البريد الإلكتروني: hello@listennotes.com

ستحصل عبر البريد الإلكتروني على إجابات مفيدة أسرع بكثير من ترتيب مكالمة هاتفية.

14. هل يمكنني استخدام Listen API على منصات من دون كود؟ 🔗

نعم، ما دامت منصة no-code التي تختارها تسمح بالاتصال بـ REST API. يمكنك مثلاً استخدام Listen API للبحث عن البودكاست في تطبيقي Bubble وRetool.

إذا أردت فقط تضمين بودكاست أو حلقة أو مقطع أو قائمة تشغيل قابلة للتشغيل في موقعك أو مدونتك، فلن تحتاج إلى Listen API. يمكنك التضمين بسهولة في WordPress وBlogger وGhost وGoogle Sites وTumblr ومنصات نشر كثيرة أخرى.

15. هل توفرون مكتبات خاصة بلغات برمجة مختلفة لـ Podcast API؟ 🔗

نعم، نوفر بعض المكتبات، وسنضيف مستقبلاً مكتبات لمزيد من اللغات.

16. ما المعلومات التي تجمعها Listen Notes من مستخدمي API؟ 🔗

نجمع الحد الأدنى من معلومات الجهاز الذي يرسل طلبات API مباشرة إلى خوادمنا: عنوان IP، وuser-agent، ونقطة النهاية ومعلمات الطلب. وهذه في الأساس سطر واحد في سجل وصول Nginx.

إذا كان مطوّر يشغّل تطبيق بودكاست ويرسل الطلبات من خوادمه، فإن خوادمه تعمل وسيطاً بين التطبيق وListen API. لذلك نسجّل فقط عنوان IP وuser-agent ونقطة النهاية والمعلمات الخاصة بخادم المطوّر، ولا نعرف مستخدمي التطبيق النهائيين.

17. هل تفرض Listen API حدوداً لمعدل الطلبات، مثل عدد محدد في الثانية؟ 🔗

نعم، نضع حدوداً معقولة لمعدل طلبات نقاط النهاية. عند الاستخدام الصحيح قد لا تلاحظها مطلقاً. وإذا كنت تحتاج إلى معدل مرتفع، فاستخدم خطة مناسبة وتواصل معنا عند الحاجة.

تهدف الحدود إلى حماية استقرار الخدمة ومنع إساءة الاستخدام، وتُرجع الطلبات المتجاوزة عادة HTTP 429.

18. هل تعالجون طلبات حذف البودكاست بموجب DMCA وGDPR والقوانين المشابهة؟ 🔗

نعم، نعالج طلبات حذف المحتوى. اعرف المزيد:

يمكنك توجيه طلبات إزالة المحتوى نيابة عن مستخدميك إلى Listen Notes عبر نقطة النهاية التالية: DELETE /podcasts/{id}، أو توجيهها إلى hello@listennotes.com.

19. هل يمكنني قانونياً بث صوت البودكاست في تطبيقاتي أو مواقعي باستخدام Listen API؟ 🔗

نعم، يمكنك قانونياً بث صوت البودكاست في تطبيقاتك أو مواقعك باستخدام Listen API. اعرف التفاصيل.

وإذا رفض App Store تطبيقك بسبب تكامله مع API، فيمكننا مساعدتك.