سوالات متداولListen API
نسخه API: V2 ·
PodcastAPI.com
پاسخ پرسش‌های عمومی Listen API.
از https://www.podcastapi.com/llms-full.txt بخوانید تا بتوانم درباره Podcast API از Listen Notes سؤال بپرسم.
سؤالی دارید؟
hello@listennotes.com
۱. چرا باید Listen API را به‌جای iTunes API انتخاب کنم؟ 🔗
همیشه می‌توانید پایگاه داده پادکست خود را بسازید و نگه دارید یا API دیگری انتخاب کنید.
ما قیمت شفاف و مستندات کامل با نمونه JSON داریم.
می‌توانید بدون کارت و گفت‌وگوی فروش با FREE شروع کنید.
در PRO یا ENTERPRISE از hello@listennotes.com سریع و مستقیم از بنیان‌گذار و CEO پاسخ می‌گیرید.
iTunes API ممکن است endpoint و داده ساختاریافته لازم را نداشته باشد، نتایج کم و ضعیف رتبه‌بندی‌شده بدهد، شرایط محدودکننده و پشتیبانی انسانی کمتری داشته باشد.
بخوانید: روش ارزیابی RESTful API شخص ثالث.
۲. ساخت پایگاه داده پادکست چقدر می‌تواند دشوار باشد؟ 🔗
ساخت پایگاه داده مناسب پادکست کاری پیوسته است و برای سرور، مهندس و نگهداری زمان و پول می‌خواهد. هزینه نگهداری بلندمدت از ساخت اولیه بیشتر است.
دست‌کم 3,831,088 پادکست و 196,732,836 قسمت وجود دارد. با 3,831,088 پادکست و 196,732,836 قسمت، RSS و نشانی صدا مرتب تغییر می‌کنند و داده باید شبانه‌روزی خودکار و دستی پاک‌سازی شود. جست‌وجو در 3,831,088 پادکست و 196,732,836 قسمت زیرساخت پیچیده‌ای می‌خواهد. محتوای جعلی نیز باید حذف و سرورها پایدار نگه داشته شوند.
بزرگ‌ترین هزینه هزینه فرصت است؛ زمانی که صرف داده می‌شود از توسعه محصول کم می‌شود.
Listen API اجازه می‌دهد فوراً روی محصول کار کنید. بیش از 2,000,000 کاربر ماهانه listennotes.com به ارسال پادکست‌های جاافتاده و اصلاح داده کمک می‌کنند و ما پایگاه باکیفیتی نگه می‌داریم.
۳. آیا از API فعالانه پشتیبانی می‌کنید و این کار ادامه خواهد داشت؟ 🔗
پاسخ هر دو مثبت است.
Listen API زیربنای وب‌سایت عمومی ListenNotes.com است و از بیشتر بهبودهای backend آن بهره می‌برد.
از ۲۰۱۷ فعال هستیم و قصد داریم مدت زیادی ادامه دهیم.
۴. اگر از Listen API استفاده کنیم و در آینده تعطیل شود چه؟ 🔗
نگرانی شما درست است؛ هیچ سرویس یا شرکتی همیشگی نیست. Google نیز محصولات زیادی را تعطیل می‌کند.
اگر Listen API را تعطیل کنیم دست‌کم ۱۲ هفته زودتر خبر می‌دهیم و می‌توانید خروجی تازه همه پادکست‌ها و قسمت‌ها را با قیمت منطقی بخرید.
Listen Notes احتمالاً از بسیاری استارتاپ‌های سرمایه‌دار بیشتر دوام می‌آورد. سبک و کم‌هزینه اداره می‌شویم، نیروی عظیم نداریم و زیرساخت را بدون هدر دادن هزینه سرور پایدار نگه می‌داریم.
۵. آیا پشتیبانی ارائه می‌کنید؟ 🔗
بله. کاربران PRO و ENTERPRISE می‌توانند پرسش‌های API را به hello@listennotes.com بفرستند. گاهی به کاربران FREE نیز پاسخ می‌دهیم، اما اولویت با PRO و ENTERPRISE است.
مستقیم با بنیان‌گذار و CEO شرکت Listen Notes صحبت می‌کنید که این سرویس را شخصاً ساخته است.
۶. درخواست‌های API بسیار زیادی خواهیم داشت. می‌توانید این مقیاس را پشتیبانی کنید؟ 🔗
هم‌اکنون شرکت‌هایی ماهانه ده‌ها میلیون درخواست با Listen API می‌فرستند. بدون افزودن سرور می‌توانیم دست‌کم ده برابر ترافیک فعلی را پاسخ دهیم.
بهترین شیوه‌های عملیات زیرساخت، پایش و هشدار را اجرا می‌کنیم و مشکلات را سریع پیدا و رفع می‌کنیم. در کارایی و پایداری سابقه خوبی داریم.
۷. می‌توانیم پاسخ API را در سمت کاربر، مثلاً داخل برنامه یا مرورگر، ذخیره موقت کنیم؟ 🔗
بله. شرایط FREE و PRO ذخیره موقت پاسخ در سمت کاربر، مانند برنامه یا مرورگر، را مجاز می‌داند؛ اما در سرور فقط podcast/episode ids و pub_dates را می‌توان دائمی نگه داشت.
فایل صوتی پادکست را می‌توانید برای ساخت کلیپ یا تبدیل گفتار به متن در سرور ذخیره و پردازش کنید.
در ENTERPRISE می‌توانید کل پاسخ را در سرور cache کنید.
۸. چرا نشانی‌های صوتی در پاسخ API از دامنه listennotes.com هستند؟ 🔗
صدا را در سرور خود نگه نمی‌داریم، بنابراین پادکستر اطلاعات تحلیلی دقیق مانند IP و user-agent شنونده را می‌گیرد.
چون نشانی صدا مرتب عوض می‌شود، نشانی دائمی خود را با HTTP 301 به نشانی واقعی هدایت می‌کنیم.
برنامه می‌تواند نشانی دائمی Listen Notes را در سمت کاربر cache کند و ما در سرور نشانی درست را پیدا و تغییرات را بررسی می‌کنیم.
۹. اگر پادکست خاصی پیدا نشود یا داده با RSS هماهنگ نباشد، مثلاً صدا خراب یا فراداده نادرست باشد، چه کنیم؟ 🔗
با وجود جامع‌بودن پایگاه داده، شاید برنامه جدیدی را فوراً پیدا نکنیم؛ همان‌طور که Google برای یافتن سایت جدید زمان می‌خواهد. می‌توانید برنامه جاافتاده را ارسال کنید.
ممکن است سازنده RSS را تغییر داده باشد، هنوز تغییر را ندیده باشیم یا RSS خطا داشته باشد. به hello@listennotes.com گزارش دهید؛ معمولاً ظرف چند دقیقه اصلاح می‌کنیم. همچنین می‌توانید از ابزارهای سلف‌سرویس اصلاح فراداده استفاده کنید.
۱۰. چگونه پایگاه داده پادکست را به‌روز نگه می‌دارید؟ 🔗
پادکست جدید را به چهار روش می‌یابیم:
- خزنده‌ها شبانه‌روزی محتوای عمومی را می‌جویند.
- پادکسترها برنامه جدید می‌فرستند.
- کارکنان موارد جاافتاده را اضافه می‌کنند و بیش از 2,000,000 کاربر ماهانه listennotes.com نیز می‌توانند برنامه جاافتاده را بفرستند. همه موارد دستی بررسی می‌شوند.
- سرویس‌های بزرگ میزبانی با Podcast API ما یکپارچه‌اند.
همه RSSها پیوسته بررسی می‌شوند. قسمت جدید پادکست‌های اخیراً استفاده‌شده در کمتر از یک ساعت، معمولاً ۱۵ تا ۳۰ دقیقه، و بقیه در ۲ تا ۴ ساعت می‌آید.
۱۱. اگر شرایط استفاده از API را نقض کنیم چه می‌شود؟ 🔗
در صورت نقض شرایط API حساب تعلیق می‌شود. اعتراض را به hello@listennotes.com بفرستید.
رایج‌ترین علت‌ها ساخت چند حساب برای دورزدن سهمیه FREE، به‌ویژه با ایمیل یک‌بارمصرف، و ذخیره بیشتر داده پاسخ در سرور است. شرایط را نقض نکنید.
۱۲. حتی در طرح پولی هم باید نشان Listen Notes را در برنامه نمایش دهیم؟ 🔗
بله. شرایط API برای همه کاربران FREE و PRO است. فقط در یک صفحه‌ای که داده ما را دارد عبارت "Powered by Listen Notes" را نشان دهید؛ لازم نیست در همه صفحه‌ها باشد و می‌تواند پایین‌تر از بخش نخست صفحه قرار بگیرد.
برای FREE یا PRO استثنا نداریم، چه توسعه‌دهنده مستقل باشید چه شرکت بورسی. سفارشی‌سازی موردی پیچیدگی کار را بالا می‌برد و از زمان بهبود محصول می‌کاهد.
نمایش منبع در APIهای داده رایج است؛ Uber نیز هنگام استفاده از Google Maps نشان Google را نمایش می‌دهد.
در ENTERPRISE درباره الزام نشان انعطاف داریم.
۱۳. می‌توانیم تلفنی درباره همکاری صحبت کنیم؟ 🔗
Listen API برای استفاده سلف‌سرویس طراحی شده است. اگر در چند دقیقه متوجه نشوید چه کاری انجام می‌دهد و چگونه باید استفاده شود، یعنی ما خوب توضیح نداده‌ایم. ابتدا به hello@listennotes.com ایمیل بزنید.
پاسخ مفید ایمیلی را بسیار سریع‌تر از هماهنگی تماس تلفنی دریافت می‌کنید.
۱۴. می‌توانم Listen API را در پلتفرم‌های بدون کدنویسی استفاده کنم؟ 🔗
بله، به‌شرطی که پلتفرم بدون کدنویسی امکان اتصال به REST API را بدهد. مثلاً با Listen API می‌توانید در برنامه‌های Bubble و Retool پادکست جست‌وجو کنید.
اگر فقط می‌خواهید پادکست، قسمت، کلیپ یا فهرست پخش قابل پخش را در سایت قرار دهید، API لازم نیست. به‌سادگی می‌توان آن‌ها را در WordPress، Blogger، Ghost، Google Sites، Tumblr و پلتفرم‌های دیگر جاسازی کرد.
۱۵. برای Podcast API کتابخانه‌های زبان‌های برنامه‌نویسی مختلف دارید؟ 🔗
۱۶. Listen Notes چه اطلاعاتی از کاربران API جمع‌آوری می‌کند؟ 🔗
فقط کمترین اطلاعات دستگاهی را که مستقیم درخواست API می‌فرستد جمع می‌کنیم: IP، user-agent، endpoint و پارامترها. این عملاً یک سطر در گزارش دسترسی Nginx است.
اگر سرور توسعه‌دهنده میان برنامه و Listen API واسطه باشد، فقط IP و user-agent سرور و endpoint و پارامترها را می‌بینیم؛ درباره کاربران نهایی برنامه چیز دیگری نمی‌دانیم.
۱۷. آیا Listen API محدودیت نرخ دارد، مثلاً N درخواست در ثانیه؟ 🔗
بله. برای endpointها محدودیت نرخ منطقی داریم. اگر API را درست استفاده کنید شاید اصلاً متوجه محدودیت نشوید.
هر REST API جدی برای جلوگیری از DDoS و حلقه‌های اشتباه درخواست به محدودیت نیاز دارد. از ۲۰۱۷ چنین خطاهایی را بیش از انتظار دیده‌ایم و یک کاربر نباید کل سامانه را مختل کند.
FREE محدودیت پایین‌تر، PRO بالاتر و ENTERPRISE بالاترین را دارد. endpointها بر اساس هزینه محاسباتی محدودیت متفاوت دارند و محدودیت کاربر جدید به‌مرور افزایش می‌یابد.
۱۸. آیا درخواست‌های حذف پادکست طبق DMCA، GDPR و قوانین مشابه را رسیدگی می‌کنید؟ 🔗
بله. درخواست حذف محتوا را رسیدگی می‌کنیم. بیشتر بخوانید:
درخواست کاربران را از طریق DELETE /podcasts/{id} یا hello@listennotes.com بفرستید.
۱۹. آیا می‌توانم با Listen API صدای پادکست را به‌طور قانونی در برنامه یا وب‌سایتم پخش کنم؟ 🔗
بله، با Listen API می‌توانید صدای پادکست را به‌طور قانونی در برنامه یا وب‌سایت پخش کنید. بیشتر بخوانید.
اگر App Store برنامه را به‌دلیل یکپارچگی API رد کند، کمکتان می‌کنیم.