Listen APIKKK
API VERSIOON: V2 ·
PodcastAPI.com
Vastused Listen API üldküsimustele.
Lugege https://www.podcastapi.com/llms-full.txt-st, et saaksin Listen Notes mudeli Podcast API kohta küsimusi esitada.
Küsimusi?
hello@listennotes.com
1. Miks eelistada Listen API-t iTunes API-le? 🔗
Võid alati luua ja hooldada oma podcastide andmebaasi või valida mõne muu API.
PRO või ENTERPRISE puhul saad aadressilt hello@listennotes.com kiire vastuse otse asutajalt ja CEO-lt.
iTunes API-s võivad puududa vajalikud endpoint'id ja struktureeritud andmed, otsingutulemusi on vähe ning need on kehvasti järjestatud, tingimused on piiravamad ja inimtugi väiksem.
2. Kui keeruline saab podcastide andmebaasi loomine olla? 🔗
Hea podcastide andmebaas nõuab pidevalt aega ja raha serveritele, arendajatele ning hooldusele. Pikaajaline hooldus maksab rohkem kui esmane loomine.
Internetis on vähemalt 3,831,088 podcasti ja 196,732,836 episoodi. 3,831,088 podcasti ja 196,732,836 episoodi juures muutuvad RSS-vood ja heli-URL-id sageli ning andmeid tuleb pidevalt automaatselt ja käsitsi puhastada. Märksõnaotsing 3,831,088 podcastis ja 196,732,836 episoodis nõuab keerukat taristut. Samuti tuleb eemaldada võltssisu ja tagada serverite töö.
Suurim kulu on alternatiivkulu: andmebaasile kuluv aeg jääb puudu tootearendusest.
Listen API võimaldab kohe tootega alustada. Üle 2,000,000 igakuise listennotes.com kasutaja aitab puuduvaid podcaste esitada ja vigu parandada, mistõttu saame kvaliteetset andmebaasi hoida.
3. Kas API-t toetatakse aktiivselt ja kas kavatsete seda jätkata? 🔗
Jah ja jah.
Listen API toetab meie avalikku veebisaiti ListenNotes.com ja saab kasu enamikust selle taustsüsteemi täiustustest.
Oleme tegutsenud alates 2017. aastast ja kavatseme jätkata veel kaua.
4. Mis saab siis, kui kasutame Listen API-t ja see tulevikus suletakse? 🔗
Mure on põhjendatud: ükski veebiteenus ega ettevõte ei kesta igavesti. Näiteks sulgeb Google sageli oma tooteid.
Kui otsustame Listen API sulgeda, teatame sellest vähemalt 12 nädalat ette ja saad mõistliku hinnaga osta värske andmeväljavõtte kõigi podcastide ning episoodidega.
Listen Notes võib kesta kauem kui paljud hästi rahastatud idufirmad. Tegutseme säästlikult, meil pole tohutut töötajaskonda ning hoiame taristu töökindlana ilma serveritele raha raiskamata.
5. Kas pakute kasutajatuge? 🔗
Jah. PRO või ENTERPRISE kasutajana kirjuta API küsimustega aadressile hello@listennotes.com. Vahel vastame ka FREE kasutajatele, kuid peame eelistama PRO ja ENTERPRISE kliente.
Suhtled otse Listen Notes, Inc.-i asutaja ja CEO-ga, kes on kogu teenuse ise üles ehitanud.
6. Teeme tohutult API päringuid. Kas suudate sellist mahtu teenindada? 🔗
Praegu teevad ettevõtted Listen API kaudu kümneid miljoneid päringuid kuus. Saame ilma servereid lisamata teenindada vähemalt kümme korda suuremat liiklust.
Järgime taristu haldamise häid tavasid ning kasutame põhjalikku seiret ja teavitusi. Probleemid leiame ja parandame kiiresti. Meie jõudluse ja töökindluse senine ajalugu on väga hea.
7. Kas API vastust võib kliendipoolel, näiteks rakenduses või brauseris, vahemällu salvestada? 🔗
Jah. FREE ja PRO tingimused lubavad vastust kliendipoolel rakenduses või brauseris vahemällu salvestada, kuid serveris tohib püsivalt hoida ainult podcast/episode ids ja pub_dates.
Podcastide helifaile võib serveris hoida ja töödelda, näiteks klippide või kõnetuvastuse jaoks.
ENTERPRISE lubab serveris kogu vastust vahemällu salvestada.
8. Miks pärinevad API vastuse heli-URL-id domeenilt listennotes.com? 🔗
Me ei hoia helifaile oma serverites, seega saavad podcasterid täpsed analüüsiandmed, näiteks kuulaja IP ja user-agent'i.
Kuna heli-URL-id muutuvad sageli, suuname meie püsiva URL-i tegelikule aadressile HTTP 301 abil.
Rakendus võib püsiva Listen Notesi URL-i kliendipoolel vahemällu salvestada, samal ajal kui meie leiame serveris õige heli-URL-i ja jälgime muudatusi.
9. Mida teha, kui kindlat podcasti ei leidu või andmed ei vasta RSS-voole, näiteks heli ei tööta või metaandmed on valed? 🔗
Kuigi andmebaas on väga põhjalik, ei pruugi me uut saadet kohe leida, nagu ka Google ei leia uut veebisaiti kohe. Sel juhul saad puuduva saate esitada.
Looja võib olla RSS-voogu muutnud, muutus pole veel meieni jõudnud või voos on viga. Teata veast aadressil hello@listennotes.com; parandame selle tavaliselt minutitega. Samuti võid kasutada iseteenindustööriistu.
10. Kuidas hoiate podcastide andmebaasi ajakohasena? 🔗
Leiame uusi podcaste neljal viisil:
- Roomajad otsivad ööpäev läbi avalikke podcaste.
- Podcasterid esitavad uusi saateid.
- Töötajad lisavad puuduvad podcastid ning üle 2,000,000 igakuise listennotes.com kasutaja saab puuduva saate esitada. Kõik esildised vaadatakse käsitsi üle.
- Suured majutusteenused integreerivad meie Podcast API.
Kontrollime kõiki RSS-vooge pidevalt. Hiljuti kasutatud podcastide uued episoodid ilmuvad tunni jooksul, tavaliselt 15–30 minutiga; ülejäänud kahe kuni nelja tunniga.
11. Mis juhtub API kasutustingimuste rikkumisel? 🔗
API kasutustingimuste rikkumisel peatatakse konto. Otsuse vaidlustamiseks kirjuta hello@listennotes.com.
Levinumad põhjused on mitme konto loomine FREE kvoodist möödahiilimiseks, eriti ühekordsete e-posti aadressidega, ning enamiku vastuseandmete serveripoolne vahemällu salvestamine. Järgi kindlasti kasutustingimusi.
12. Kas tasulise paketi puhul peab rakenduses ikkagi Listen Notesi logo kuvama? 🔗
Jah. API kasutustingimused kehtivad kõigile FREE ja PRO kasutajatele. "Powered by Listen Notes" tuleb kuvada ainult ühel meie andmeid kasutaval kuval, mitte igal kuval. Logo võib olla ka algselt nähtavast alast allpool.
FREE ja PRO kasutajatele erandeid ei tehta, olgu tegemist üksikarendaja või börsiettevõttega. Ühekordsed erilahendused suurendavad töö keerukust ja võtavad aega põhitoodete täiustamiselt.
Allika näitamine on andme-API-de puhul tavaline; näiteks kuvab Uber Google Mapsi kasutades Google'i logo.
ENTERPRISE puhul saame logonõuet paindlikumalt käsitleda.
13. Kas saame koostööst telefoni teel rääkida? 🔗
Listen API on loodud iseteeninduseks. Kui mõne minutiga ei selgu, mida see teeb ja kuidas seda kasutada, pole me piisavalt hästi selgitanud. Küsimuste korral kirjuta esmalt hello@listennotes.com.
E-posti teel saad sisuka vastuse palju kiiremini kui telefonikõnet kokku leppides.
14. Kas Listen API-t saab kasutada koodivabadel platvormidel? 🔗
Jah, kui valitud koodivaba platvorm võimaldab REST API-ga ühendust luua. Listen API-t saab kasutada näiteks podcastide otsimiseks Bubble'i ja Retooli rakendustes.
Kui soovid vaid esitatavaid podcaste, episoode, klippe või esitusloendeid veebisaidile lisada, pole API-t vaja. Neid saab hõlpsalt lisada WordPressi, Bloggerisse, Ghosti, Google Sitesi, Tumblrisse ja paljudele teistele platvormidele.
15. Kas pakute Podcast API jaoks eri programmeerimiskeelte teeke? 🔗
16. Millist teavet kogub Listen Notes API kasutajate kohta? 🔗
Kogume API päringuid otse saatva seadme kohta vaid minimaalselt teavet: IP-aadressi, user-agent'i ning endpoint'i ja parameetreid. See on sisuliselt üks rida Nginxi juurdepääsulogis.
Kui arendaja server toimib rakenduse ja Listen API vahel puhverserverina, näeme ainult selle serveri IP-d ja user-agent'i ning päringu endpoint'i ja parameetreid. Rakenduse lõppkasutajate kohta me muud ei tea.
17. Kas Listen API-l on päringusageduse piirangud, näiteks N päringut sekundis? 🔗
Jah. API endpoint'idel on mõistlikud päringusageduse piirangud. Õige kasutuse korral ei pruugi sa neid märgatagi.
Iga tõsine REST API vajab piiranguid DDoS-i ja juhuslike päringutsüklite vältimiseks. Alates 2017. aastast oleme selliseid vigu näinud oodatust sagedamini ning üks kasutaja ei tohi kogu süsteemi mõjutada.
FREE piir on madalam, PRO-l kõrgem ja ENTERPRISE'il kõrgeim. Endpoint'ide piirid sõltuvad arvutusmahust ning uute kasutajate algseid piire suurendatakse aja jooksul.
18. Kas käsitlete DMCA, GDPR-i ja sarnaste seaduste alusel esitatud podcastide kustutamistaotlusi? 🔗
Jah. Käsitleme sisu eemaldamistaotlusi. Loe lähemalt:
Kasutajate taotlused saab edastada endpoint'ile DELETE /podcasts/{id} või aadressile hello@listennotes.com.
19. Kas Listen API abil võib podcastide heli rakendustes või veebisaitidel seaduslikult voogedastada? 🔗
Jah, Listen API abil võib podcastiheli rakendustes ja veebisaitidel seaduslikult voogedastada. Loe lähemalt.
Kui App Store lükkab rakenduse API integratsiooni tõttu tagasi, aitame sind.