Listen APIЧесто задавани въпроси

API ВЕРСИЯ: V2 · PodcastAPI.com

Отговори на общи въпроси за Listen API.

Прочетете от https://www.podcastapi.com/llms-full.txt, за да мога да задавам въпроси относно Podcast API от Listen Notes.

Въпроси? hello@listennotes.com

1. Защо да използвам Listen API вместо iTunes API? 🔗

Винаги можете да изградите собствена база с подкасти или да изберете друг API.

За оценка на Listen API предлагаме прозрачни цени и пълна документация с примерни JSON отговори.

Можете директно да започнете с FREE без карта, без разговор с търговец.

При PRO или ENTERPRISE пишете на hello@listennotes.com за бърз отговор от основателя и изпълнителен директор.

iTunes API може да не е подходящ, защото има по-малко крайни точки и структурирани данни, ограничени резултати, условия, които може да забраняват желаната употреба, и по-трудна човешка поддръжка.

Вижте: Как да оцените 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 е основа на собствените ни продукти и го използваме ежедневно, така че имаме силен стимул да го поддържаме. При съществена промяна ще дадем разумен срок и възможности за миграция.

5. Предлагате ли поддръжка? 🔗

Да. Ако използвате PRO или ENTERPRISE, пишете на hello@listennotes.com и ще помогнем.

Обикновено отговаряме за минути и общувате директно с основателя и изпълнителен директор на Listen Notes.

6. Ще използваме огромен брой API заявки. Можете ли да поддържате този мащаб? 🔗

Компании вече изпращат десетки милиони заявки месечно чрез Listen API. Инфраструктурата ни се мащабира и може да поддържа вашия обем.

При специални изисквания за капацитет или производителност пишете на hello@listennotes.com.

7. Можем ли да кешираме API отговора от страна на клиента? 🔗

Да. Условията за FREE и PRO позволяват клиентско кеширане в приложение или браузър за по-добра производителност. Не е позволено обаче да кеширате или разпространявате по-голямата част от базата на сървъра.

Обновявайте кеша периодично. ENTERPRISE предлага по-гъвкава сървърна политика.

8. Защо аудио URL адресите в API отговора са от домейна listennotes.com? 🔗

Не съхраняваме аудиофайловете на наши сървъри, затова създателите продължават да получават точни анализи за слушателите.

Обвиваме оригиналния аудио URL с наш постоянен адрес чрез HTTP 301, защото тези адреси често се променят.

Приложението може да кешира постоянния Listen Notes URL, а ние намираме правилния аудио адрес на сървъра и следим промените.

9. Какво да направим, ако липсва подкаст или данните не съвпадат с RSS емисията? 🔗

Въпреки широкото покритие може да не открием ново предаване веднага. Тогава можете да изпратите липсващия подкаст.

Възможно е създателят да е сменил RSS емисията или тя да съдържа грешка. Съобщете за грешни метаданни на hello@listennotes.com или използвайте инструментите за самостоятелна корекция.

10. Как поддържате базата данни с подкасти актуална? 🔗

Откриваме нови подкасти по четири начина:

Денонощни роботи намират публични подкасти.
Създателите сами изпращат нови предавания.
Служителите ни добавят липсващи подкасти, а над 2,000,000 месечни потребители на listennotes.com могат да изпращат липсващи предавания. Преглеждаме всичко ръчно и отхвърляме фалшивото съдържание.
Големи хостинг услуги се интегрират с нашия Podcast API.

Проверяваме RSS емисиите непрекъснато. Новите епизоди на наскоро използвани подкасти се добавят до час, обикновено за 15–30 минути; останалите — за 2–4 часа.

11. Какво става, ако нарушим Условията за използване на API? 🔗

Профилът ви ще бъде спрян при нарушение на Условията за използване на API. Можете да обжалвате на hello@listennotes.com.

Най-честите причини са множество профили за заобикаляне на квотата FREE, особено с временни имейли, и сървърно кеширане на по-голямата част от отговорите.

12. Трябва ли да показваме логото на Listen Notes в приложението си при платен план? 🔗

Да. Условията за API важат за FREE и PRO. Достатъчно е да покажете "Powered by Listen Notes" на един екран, който използва данните ни; логото може да е под първоначално видимата част.

Не правим изключения за FREE/PRO, защото еднократните промени увеличават сложността и отнемат време от основния продукт.

Посочването на източника е обичайно за API за данни, както при Google Maps в Uber.

При ENTERPRISE можем да бъдем гъвкави относно логото.

13. Можем ли да обсъдим партньорството си по телефона? 🔗

Listen API е проектиран за самообслужване. Ако за няколко минути не разберете какво може и как се използва, значи ние не сме го обяснили добре. Първо ни пишете на hello@listennotes.com.

По имейл ще получите полезен отговор много по-бързо, отколкото чрез насрочване на разговор.

14. Мога ли да използвам Listen API в no-code платформи? 🔗

Да, ако избраната no-code платформа може да се свързва с REST API. Например Listen API работи с Bubble и Retool.

За вграждане на подкасти, епизоди, клипове или плейлисти не ви е нужен API. Можете да ги вградите в WordPress, Blogger, Ghost, Google Sites, Tumblr и други платформи.

15. Предлагате ли библиотеки за различни програмни езици? 🔗

Да. Вече имаме няколко и занапред ще добавяме библиотеки за още езици.

16. Каква информация събира Listen Notes от потребителите на API? 🔗

Събираме минимална информация за устройството, което изпраща API заявки: IP адрес, user-agent, крайна точка и параметри — по същество един ред в Nginx журнал.

Ако заявките идват от сървърите на разработчика, те са посредник между приложението и Listen API. Тогава знаем само IP, user-agent, крайната точка и параметрите на сървъра, но не и крайните потребители.

17. Има ли Listen API ограничения на честотата на заявките? 🔗

Да. Задаваме разумни ограничения на честотата на заявките. При правилна употреба вероятно няма да ги забележите. При нужда от висок капацитет изберете подходящ план и се свържете с нас.

Ограниченията пазят стабилността и предотвратяват злоупотреби; превишените заявки обикновено връщат HTTP 429.

18. Обработвате ли искания за изтриване по DMCA, GDPR и подобни закони? 🔗

Да, обработваме искания за изтриване. Научете повече:

Можете да препратите исканията на потребителите чрез DELETE /podcasts/{id} или към hello@listennotes.com.

19. Мога ли законно да стриймвам аудио от подкасти чрез Listen API? 🔗

Да, можете законно да стриймвате аудио от подкасти чрез Listen API. Научете повече.

Ако App Store отхвърли приложението заради интеграцията, можем да помогнем.