Soalan LazimListen API

1. Mengapakah saya patut menggunakan Listen API berbanding iTunes API? 🔗

Anda sentiasa mempunyai pilihan lain: bina dan selenggara pangkalan data sendiri, atau pilih Podcast API lain di Internet.

Untuk membantu penilaian, kami menyediakan model harga yang telus dan mudah serta dokumentasi lengkap bagi semua endpoint dan contoh response JSON.

Listen API mudah dicuba: tidak perlu bercakap dengan jurujual atau meminta demo. Langgan pelan FREE tanpa maklumat kad dan mula menggunakannya.

Pengguna PRO/ENTERPRISE boleh menghantar soalan ke hello@listennotes.com dan bercakap terus dengan pengasas dan CEO Listen Notes.

Bagaimana dengan iTunes API daripada Apple? Baca dokumentasi dan cuba sendiri. Ia mungkin tidak sesuai kerana

endpoint dan data berstruktur tidak mencukupi untuk sesetengah ciri asas;
hasil carian sedikit dan ranking kurang ideal;
syarat perkhidmatan mungkin tidak membenarkan kegunaan anda;
mungkin tidak diselenggara secara aktif kerana bukan produk utama Apple;
sokongan manusia penting bagi API enterprise, tetapi jawapan pantas daripada Apple mungkin sukar diperoleh.

Artikel ini mungkin berguna: How to evaluate a 3rd party RESTful API?

2. Seberapa sukarkah membina pangkalan data podcast? 🔗

Membina pangkalan data podcast yang baik ialah usaha berterusan. Ia tidak sukar, tetapi memerlukan masa dan wang untuk server serta engineer. Seperti kereta atau rumah, kos penyelenggaraan dan masa anda lebih besar daripada kos awal.

Pertimbangkan perkara berikut:

Internet mempunyai sekurang-kurangnya 3,831,088 podcast dan 196,732,836 episod dan jumlahnya berkembang pantas. Data perlu dihos dan dikemas kini.
Dengan 3,831,088 podcast dan 196,732,836 episod, RSS feed dan URL audio berubah lebih kerap daripada jangkaan. Alat automatik dan proses manual sepanjang masa diperlukan.
Carian keyword merentasi 3,831,088 podcast dan 196,732,836 episod memerlukan enjin carian. UI kelihatan mudah tetapi backend amat rumit—ada sebab Google menggaji 175,000 pekerja tetap pada 2022 dan ratusan ribu contractor.
Terdapat banyak podcast palsu yang dijana mesin atau untuk Black Hat SEO. Proses automatik dan manual diperlukan. Google mempunyai pasukan web spam khusus; Listen Notes juga memperuntukkan banyak sumber.
Pangkalan data dan enjin carian yang beroperasi sepanjang masa memerlukan kerja untuk mengelakkan gangguan server.
Bandingkan kos software engineer tetap yang cekap dengan perkhidmatan cloud pihak ketiga seperti API kami.

Kos terbesar sebenarnya ialah kos peluang. Masa membina pangkalan data sendiri tidak boleh digunakan untuk membina aplikasi atau laman anda.

Listen API membolehkan anda segera memulakan bahagian projek yang paling menarik. Lebih 2,000,000 orang menggunakan listennotes.com setiap bulan dan membantu menghantar podcast yang belum tersenarai serta membetulkan data. Bantuan pengguna seluruh dunia memastikan kualiti tinggi.

3. Adakah API ini disokong secara aktif dan akan terus disokong? 🔗

Ya dan ya.

Listen API menggerakkan laman umum ListenNotes.com dan menerima manfaat daripada kebanyakan penambahbaikan backend Listen Notes. Kami beroperasi sejak 2017 dan merancang untuk terus beroperasi dalam jangka panjang.

4. Bagaimana jika kami menggunakan Listen API dan perkhidmatan ini ditamatkan pada masa hadapan? 🔗

Kebimbangan anda berasas. Tiada perkhidmatan atau syarikat dalam talian yang kekal selamanya; contohnya, Google menamatkan banyak produknya.

Jika Listen API ditamatkan, kami akan memberi notis sekurang-kurangnya 12 minggu dan anda boleh membeli dump pangkalan data terkini—semua podcast dan episod—pada harga yang agak rendah.

Listen Notes mungkin bertahan lebih lama daripada banyak startup berbiaya besar atau syarikat awam. Kami beroperasi secara cekap tanpa ramai pekerja dan beban gaji. Infrastruktur direka kukuh tanpa membazir kos server.

5. Adakah anda menyediakan sokongan? 🔗

Ya. Pengguna PRO/ENTERPRISE boleh menghantar soalan API ke hello@listennotes.com. Untuk debugging, kami mungkin meminta sample code atau request/response. Sokongan peribadi tidak dijamin bagi FREE, tetapi dokumentasi dan FAQ tersedia.

6. Kami akan menggunakan sangat banyak permintaan API. Bolehkah anda menyokong skala kami? 🔗

Kini terdapat syarikat yang menjalankan puluhan juta permintaan sebulan melalui Listen API. Tanpa menambah server, kami boleh mengendalikan sekurang-kurangnya 10 kali traffic semasa.

Jika anda merancang skala sangat besar, hubungi hello@listennotes.com supaya kami boleh membantu capacity planning.

7. Bolehkah response API disimpan dalam cache di sisi klien, seperti aplikasi atau pelayar web? 🔗

Ya. API Terms of Use bagi FREE dan PRO membenarkan cache response di sisi klien, tetapi bukan di server kecuali podcast/episode id dan pub_date.

Hanya id dan pub_date boleh disimpan secara kekal di server atau pangkalan data anda. Dasar no-caching lazim bagi Data API, contohnya Google Maps API (cari "No Scraping").

Fail audio sebenar boleh disimpan dan diproses di server, seperti membuat klip atau speech-to-text.

Pelan ENTERPRISE membenarkan keseluruhan response data dicache di server.

8. Mengapakah URL audio dalam response API menggunakan domain listennotes.com? 🔗

Kami tidak menyimpan audio di server sendiri. Podcaster masih menerima analytics tepat seperti IP dan user-agent pendengar.

Oleh sebab URL audio kerap berubah, URL sebenar dibalut dengan URL kekal kami melalui HTTP 301, contohnya audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d.

Aplikasi lazimnya cache data di klien untuk prestasi. Aplikasi menyimpan URL Listen Notes yang kekal, manakala server kami mencari URL audio yang betul dan sentiasa memeriksa perubahan.

9. Bagaimana jika podcast tertentu tidak ditemui atau data tidak selaras dengan RSS feed, seperti audio rosak atau metadata salah? 🔗

Walaupun pangkalan data sangat menyeluruh, sesetengah rancangan baharu mungkin tidak ditambah tepat pada masanya, seperti crawler Google yang memerlukan masa untuk mengindeks laman baharu. Anda boleh membantu menghantar rancangan yang belum tersenarai.

Pencipta juga mungkin menukar RSS feed sebelum kami mengesannya, atau feed mengandungi ralat. Ini seperti hasil Google yang menuju ke halaman lama atau 404. Laporkan ralat metadata ke hello@listennotes.com dan biasanya kami membetulkannya dalam beberapa minit. Anda juga boleh menggunakan alat self-service untuk membetulkan metadata :)

10. Bagaimanakah anda memastikan pangkalan data podcast sentiasa terkini? 🔗

Kami mencari podcast baharu melalui empat kaedah.

Crawler beroperasi sepanjang masa untuk mencari podcast umum.
Podcaster menghantar rancangan baharu sendiri; kami menerima ratusan penghantaran setiap hari.
Kakitangan menambah podcast yang belum tersenarai secara manual. Lebih 2,000,000 orang menggunakan listennotes.com setiap bulan dan boleh menghantar rancangan yang belum tersenarai. Semua penghantaran disemak dan podcast palsu ditolak.
Perkhidmatan pengehosan utama berintegrasi dengan Podcast API kami supaya rancangan boleh dihantar terus.

Semua RSS feed diperiksa sepanjang masa. Episod baharu bagi podcast yang baru didengar dimasukkan dalam satu jam, biasanya 15–30 minit. Podcast lain biasanya dikemas kini dalam 2–4 jam.

11. Apakah yang berlaku jika kami melanggar API Terms of Use? 🔗

Akaun akan digantung jika melanggar API Terms of Use. Hantar rayuan ke hello@listennotes.com.

Dua sebab paling biasa ialah: 1. mencipta beberapa akaun untuk mengelakkan kuota FREE, terutamanya dengan alamat e-mel pakai buang; 2. menyimpan kebanyakan response data dalam cache server. Pastikan anda mematuhi API Terms of Use.

12. Adakah logo Listen Notes perlu dipaparkan dalam aplikasi walaupun kami menggunakan pelan berbayar? 🔗

Ya. API Terms of Use terpakai kepada semua pengguna FREE/PRO. Anda hanya perlu memaparkan "Powered by Listen Notes" pada satu skrin yang menggunakan data kami, bukan setiap skrin.

ENTERPRISE tidak memerlukan logo.

Pemain HTML embed dan Listen API ialah produk berbeza. Logo pemain tidak boleh dibuang walaupun anda menggunakan pelan API berbayar.

13. Bolehkah kami membincangkan kerjasama melalui telefon? 🔗

Listen API direka untuk self-service. Jika fungsi dan cara penggunaannya tidak dapat difahami dalam beberapa minit, reka bentuk atau dokumentasi kami perlu diperbaiki.

Jika perbincangan kerjasama melalui telefon benar-benar diperlukan, hubungi hello@listennotes.com terlebih dahulu.

14. Bolehkah saya menggunakan Listen API pada platform no-code? 🔗

Ya, selagi platform no-code pilihan anda boleh disambungkan kepada REST API. Contohnya, Listen API boleh digunakan untuk mencari podcast dalam aplikasi Bubble dan Retool.

Jika anda hanya mahu membenamkan podcast, episod, klip atau playlist yang boleh dimainkan pada laman atau blog, Listen API tidak diperlukan. Anda boleh membenamkannya dengan mudah di WordPress, Blogger, Ghost, Google Sites, Tumblr dan pelbagai platform penerbitan lain.

15. Adakah anda menyediakan library Podcast API untuk bahasa pengaturcaraan tertentu? 🔗

Ya, beberapa library tersedia. Kami akan menambah lebih banyak bahasa pada masa hadapan.

16. Apakah maklumat yang dikumpulkan oleh Listen Notes daripada pengguna API? 🔗

Kami hanya mengumpulkan maklumat minimum tentang device yang menghantar permintaan terus ke server: 1) IP address; 2) user-agent; 3) endpoint dan parameter. Ini pada asasnya satu baris dalam Nginx access log.

Dalam aplikasi podcast biasa, permintaan dihantar daripada server pembangun, bukan aplikasi pengguna. Server bertindak sebagai proxy. Oleh itu kami hanya mengetahui IP server, user-agent, endpoint dan parameter; kami tidak mengetahui maklumat lain tentang pengguna akhir.

17. Adakah Listen API mempunyai had kadar, contohnya N permintaan sesaat? 🔗

Ya. Kami menetapkan had kadar yang munasabah. Jika API digunakan dengan betul, anda mungkin tidak menyedarinya.

Setiap REST API yang serius memerlukan had kadar—cari "api rate limit" di Google. Tanpanya, API mudah diserang DDoS atau dibanjiri permintaan akibat loop yang salah. Pengalaman sejak 2017 menunjukkan perkara ini berlaku lebih kerap daripada jangkaan. Seorang pengguna tidak sepatutnya menjejaskan seluruh sistem dan pengguna lain.

FREE mempunyai had rendah, PRO lebih tinggi dan ENTERPRISE paling tinggi. Setiap endpoint boleh mempunyai had berbeza mengikut beban pengiraan. Pengguna baharu bermula dengan had agak rendah yang dinaikkan dari semasa ke semasa.

18. Adakah anda mengendalikan permintaan pemadaman berdasarkan DMCA, GDPR dan undang-undang serupa? 🔗

Ya. Kami mengendalikan permintaan pemadaman kandungan. Ketahui:

Permintaan pengguna boleh dihantar melalui DELETE /podcasts/{id} atau diarahkan ke hello@listennotes.com.

19. Bolehkah saya menstrim audio podcast secara sah dalam aplikasi atau laman web menggunakan Listen API? 🔗

Sudah tentu. Anda boleh menstrim audio podcast secara sah dalam aplikasi atau laman menggunakan Listen API. Ketahui selanjutnya.

Jika App Store menolak aplikasi kerana integrasi API kami, kami sedia membantu.