Listen APIUKK

API VERSIO: V2 · PodcastAPI.com

Vastauksia Listen API:n yleisiin kysymyksiin.

Lue https://www.podcastapi.com/llms-full.txt, jotta voin esittää kysymyksiä Listen Notes:n Podcast API:stä.

Kysymyksiä? hello@listennotes.com

1. Miksi käyttäisin Listen API:a iTunes API:n sijaan? 🔗

Voit aina rakentaa ja ylläpitää oman podcast-tietokannan tai valita toisen API:n.

Tarjoamme läpinäkyvän hinnoittelun ja kattavan dokumentaation JSON-esimerkkeineen.

Voit aloittaa FREE-paketilla ilman korttia ja myyntipuhelua.

PRO- tai ENTERPRISE-paketilla saat osoitteesta hello@listennotes.com nopeasti vastauksen suoraan perustajalta ja CEO:lta.

iTunes API:sta voi puuttua tarvittavia endpointeja ja jäsenneltyä dataa; hakutuloksia on vähän ja ne ovat heikosti järjestettyjä, ehdot ovat rajoittavammat ja henkilökohtaista tukea on vähemmän.

Lue: Kolmannen osapuolen RESTful API:n arviointi.

2. Kuinka vaikeaa podcast-tietokannan rakentaminen voi olla? 🔗

Hyvän podcast-tietokannan rakentaminen vaatii jatkuvasti aikaa ja rahaa palvelimiin, kehittäjiin ja ylläpitoon. Pitkän aikavälin ylläpito maksaa enemmän kuin alkuperäinen rakentaminen.

Verkossa on vähintään 3,831,088 podcastia ja 196,732,836 jaksoa. Kun podcasteja on 3,831,088 ja jaksoja 196,732,836, RSS-syötteet ja ääni-URL:t muuttuvat usein ja dataa täytyy siivota automaattisesti ja käsin ympäri vuorokauden. Hakeminen 3,831,088 podcastista ja 196,732,836 jaksosta vaatii monimutkaisen infrastruktuurin. Lisäksi valesisältö on poistettava ja palvelinten toiminta varmistettava.

Suurin kustannus on vaihtoehtoiskustannus: tietokantaan käytetty aika on pois tuotteesi kehittämisestä.

Listen API:n avulla pääset heti tuotteesi pariin. Yli 2,000,000 kuukausittaista listennotes.com-käyttäjää auttaa ilmoittamaan puuttuvia podcasteja ja korjaamaan virheitä, joten pystymme ylläpitämään laadukasta tietokantaa.

3. Ylläpidättekö API:a aktiivisesti, ja aiotteko jatkaa sitä? 🔗

Kyllä ja kyllä.

Listen API toimii julkisen ListenNotes.com-sivustomme pohjana ja hyötyy useimmista sen taustajärjestelmän parannuksista.

Olemme toimineet vuodesta 2017 ja aiomme jatkaa pitkään.

4. Mitä jos käytämme Listen API:a ja se lopetetaan tulevaisuudessa? 🔗

Huolesi on aiheellinen: mikään verkkopalvelu tai yritys ei kestä ikuisesti. Googlekin lopettaa monia omia tuotteitaan.

Jos päätämme lopettaa Listen API:n, ilmoitamme siitä vähintään 12 viikkoa etukäteen ja voit ostaa tuoreen vedoksen kaikista podcasteista ja jaksoista kohtuulliseen hintaan.

Listen Notes kestää todennäköisesti pidempään kuin monet hyvin rahoitetut startupit. Toimimme kevyesti ilman valtavaa henkilöstöä ja pidämme infrastruktuurin vakaana tuhlaamatta rahaa palvelimiin.

5. Tarjoatteko tukea? 🔗

Kyllä. Jos tilaat PRO- tai ENTERPRISE-paketin, lähetä API-kysymykset osoitteeseen hello@listennotes.com. Vastaamme joskus myös FREE-käyttäjille, mutta PRO- ja ENTERPRISE-käyttäjät ovat etusijalla.

Keskustelet suoraan Listen Notes, Inc.:n perustajan ja CEO:n kanssa. Hän on rakentanut koko palvelun itse.

6. Teemme valtavasti API-pyyntöjä. Pystyttekö palvelemaan meitä tässä mittakaavassa? 🔗

Yritykset tekevät Listen API:lla jo kymmeniä miljoonia pyyntöjä kuukaudessa. Pystymme palvelemaan vähintään kymmenkertaisen liikenteen lisäämättä palvelimia.

Noudatamme infrastruktuurin hyviä toimintatapoja ja käytämme kattavaa valvontaa sekä hälytyksiä. Löydämme ja korjaamme ongelmat nopeasti. Suorituskykymme ja käytettävyytemme historia on erittäin hyvä.

7. Voimmeko tallentaa API-vastauksen välimuistiin asiakaspuolella, esimerkiksi sovelluksessa tai selaimessa? 🔗

Kyllä. FREE- ja PRO-ehtojen mukaan vastauksen saa tallentaa asiakaspuolen välimuistiin sovelluksessa tai selaimessa, mutta palvelimelle saa tallentaa pysyvästi vain podcast/episode ids ja pub_dates.

Podcastien äänitiedostoja saa säilyttää ja käsitellä palvelimella esimerkiksi leikkeiden tai puheentunnistuksen tekemistä varten.

ENTERPRISE-paketissa koko vastauksen saa tallentaa palvelimen välimuistiin.

8. Miksi API-vastauksen ääni-URL-osoitteet ovat listennotes.com-verkkotunnuksesta? 🔗

Emme säilytä ääntä omilla palvelimillamme, joten podcastaajat saavat tarkat analyysitiedot, kuten kuuntelijan IP:n ja user-agentin.

Koska ääni-URL:t muuttuvat usein, ohjaamme pysyvän URL:mme oikeaan osoitteeseen HTTP 301 -uudelleenohjauksella.

Sovellus voi tallentaa pysyvän Listen Notes -URL:n asiakaspuolelle, kun me selvitämme palvelimella oikean ääniosoitteen ja seuraamme muutoksia.

9. Mitä teen, jos tiettyä podcastia ei löydy tai data ei vastaa RSS-syötettä, esimerkiksi ääni on rikki tai metatiedot ovat väärin? 🔗

Vaikka tietokantamme on hyvin kattava, emme ehkä löydä uutta ohjelmaa heti, aivan kuten Google tarvitsee aikaa uusien sivustojen löytämiseen. Voit ilmoittaa puuttuvan ohjelman.

Tekijä on voinut vaihtaa RSS-syötettä, emme ole vielä havainneet muutosta tai syötteessä on virhe. Ilmoita virhe osoitteeseen hello@listennotes.com; korjaamme sen yleensä muutamassa minuutissa. Voit myös käyttää metatietojen itsepalvelukorjausta.

10. Miten pidätte podcast-tietokannan ajan tasalla? 🔗

Löydämme uusia podcasteja neljällä tavalla:

Indeksointirobotit etsivät julkista sisältöä ympäri vuorokauden.
Podcastaajat ilmoittavat uusia ohjelmia.
Työntekijät lisäävät puuttuvia podcasteja, ja yli 2,000,000 kuukausittaista listennotes.com-käyttäjää voi ilmoittaa puuttuvan ohjelman. Kaikki tarkistetaan käsin.
Suuret hosting-palvelut integroituvat Podcast API:imme.

Tarkistamme kaikki RSS-syötteet jatkuvasti. Äskettäin käytettyjen podcastien uudet jaksot tulevat tunnin sisällä, yleensä 15–30 minuutissa; muiden 2–4 tunnissa.

11. Mitä tapahtuu, jos rikomme API:n käyttöehtoja? 🔗

Tili jäädytetään API:n käyttöehtojen rikkomisesta. Voit valittaa osoitteeseen hello@listennotes.com.

Yleisimmät syyt ovat useiden tilien luominen FREE-kiintiön kiertämiseksi, etenkin kertakäyttöisillä sähköpostiosoitteilla, sekä valtaosan vastausdatasta tallentaminen palvelimen välimuistiin. Noudata käyttöehtoja.

12. Onko Listen Notesin logo näytettävä sovelluksessa myös maksullisella paketilla? 🔗

Kyllä. API:n käyttöehdot koskevat kaikkia FREE- ja PRO-käyttäjiä. "Powered by Listen Notes" tarvitsee näyttää vain yhdellä dataamme käyttävällä näkymällä, ei jokaisella. Logo voi olla aloitusnäkymän alapuolella.

Emme tee poikkeuksia FREE- tai PRO-käyttäjille riippumatta siitä, oletko yksittäinen kehittäjä vai pörssiyhtiö. Kertaluonteiset erikoisratkaisut lisäävät monimutkaisuutta ja vievät aikaa ydintuotteen kehittämiseltä.

Lähdemerkintä on data-API:eissa tavallinen käytäntö; esimerkiksi Uber näyttää Google-logon käyttäessään Google Mapsia.

ENTERPRISE-paketissa voimme joustaa logovaatimuksesta.

13. Voimmeko keskustella yhteistyöstä puhelimitse? 🔗

Listen API on suunniteltu itsepalveluksi. Jos sen ominaisuudet ja käyttö eivät selviä muutamassa minuutissa, emme ole selittäneet niitä riittävän hyvin. Lähetä kysymyksesi ensin osoitteeseen hello@listennotes.com.

Saat hyödyllisen vastauksen sähköpostitse paljon nopeammin kuin varaamalla puhelun.

14. Voinko käyttää Listen API:a no-code-alustoilla? 🔗

Kyllä, jos valitsemasi no-code-alusta voi yhdistää REST API:in. Listen API:lla voi esimerkiksi hakea podcasteja Bubble- ja Retool-sovelluksissa.

Jos haluat vain upottaa toistettavia podcasteja, jaksoja, leikkeitä tai soittolistoja, et tarvitse API:a. Ne voi upottaa helposti WordPressiin, Bloggeriin, Ghostiin, Google Sitesiin, Tumblriin ja monille muille alustoille.

15. Tarjoatteko Podcast API:lle ohjelmointikielikohtaisia kirjastoja? 🔗

Kyllä. Joitakin kirjastoja on jo saatavilla, ja lisäämme tulevaisuudessa uusia ohjelmointikieliä.

16. Mitä tietoja Listen Notes kerää API-käyttäjistä? 🔗

Keräämme vain vähimmäistiedot laitteesta, joka lähettää API-pyynnöt suoraan: IP-osoitteen, user-agentin, endpointin ja parametrit. Tämä vastaa yhtä riviä Nginx-lokissa.

Jos kehittäjän palvelin välittää pyynnöt sovelluksen ja Listen API:n välillä, näemme vain palvelimen IP:n ja user-agentin sekä endpointin ja parametrit. Emme saa muita tietoja sovelluksen loppukäyttäjistä.

17. Onko Listen API:ssa nopeusrajoituksia, esimerkiksi N pyyntöä sekunnissa? 🔗

Kyllä. API-endpointeissa on kohtuulliset nopeusrajoitukset. Jos käytät API:a oikein, et ehkä huomaa niitä lainkaan.

Jokainen vakavasti otettava REST API tarvitsee rajoitukset DDoS-hyökkäysten ja tahattomien pyyntösilmukoiden torjumiseksi. Olemme vuodesta 2017 lähtien nähneet tällaisia virheitä odotettua useammin, eikä yhden käyttäjän pidä voida häiritä koko järjestelmää.

FREE-paketissa raja on matalin, PRO:ssa korkeampi ja ENTERPRISE:ssa korkein. Endpointien rajat vaihtelevat laskentakustannusten mukaan, ja uusien käyttäjien aloitusrajoja nostetaan ajan myötä.

18. Käsittelettekö DMCA:n, GDPR:n ja vastaavien lakien mukaisia podcastien poistopyyntöjä? 🔗

Kyllä. Käsittelemme sisällön poistopyynnöt. Lue lisää:

Voit välittää käyttäjiesi pyynnöt endpointilla DELETE /podcasts/{id} tai osoitteeseen hello@listennotes.com.

19. Voinko suoratoistaa podcast-ääntä laillisesti sovelluksissani tai sivustoillani Listen API:n avulla? 🔗

Kyllä, voit suoratoistaa podcast-ääntä laillisesti sovelluksissasi tai sivustoillasi Listen API:n avulla. Lue lisää.

Jos App Store hylkää sovelluksesi API-integraation vuoksi, autamme sinua.