TunepingBot/0.1 (+https://tuneping.com/bot)

TunepingBot w Twoich logach? Oto wszystko, co robi.

Co 20 do 60 sekund czyta publiczny tytuł „teraz gra” Twojej stacji, po kilka KB naraz, i nigdy nie dotyka dźwięku. Jeśli wolisz, żeby tego nie robił, każdy z trzech sposobów rezygnacji poniżej działa trwale w ciągu 24 godzin. Bez pytań.

To: [email protected]
Subject: Opt-out
Body: stream.example.net

User-agent: TunepingBot
Disallow: /

X-Robots-Tag: noindex

Najważniejsze fakty

Kim jesteśmy

Tuneping to mała usługa, która prowadzi bieżący indeks tego, co grają internetowe stacje radiowe, aby słuchacze i deweloperzy mogli wyszukać utwór na wielu stacjach, przejrzeć historię odtworzeń stacji albo dostać powiadomienie, gdy zacznie się utwór z listy życzeń. Indeks powstaje wyłącznie z metadanych tytułów, które stacje i tak publikują każdemu słuchaczowi. Serwer obsługuje tylko metadane; nigdy nie przechowuje, nie przekazuje ani nie redystrybuuje dźwięku.

Jeśli stacja ma endpoint statusu, zawsze go wybieramy, bo kosztuje Cię kilkaset bajtów zamiast krótkiego fragmentu dźwięku.

Jak często i jak się zachowuje

• Interwał: co 20 s dla tanich endpointów statusu, co 60 s dla metadanych w strumieniu (30 s dla niewielkiej liczby stacji, które użytkownik wprost poprosił śledzić). Strony statusu duże w stosunku do liczby obsługiwanych stacji są proporcjonalnie odpytywane rzadziej, tak by stacja nigdy nie kosztowała więcej bajtów na minutę niż jedno sprawdzenie w strumieniu. Stacje, których tytuł nie zmienił się od 30 minut, są odpytywane co 5 minut. Interwały mają losowe odchylenie plus minus 10 %, by stacje na jednym serwerze nie były odpytywane w tym samym rytmie.
• Współbieżność: najwyżej 2 otwarte połączenia naraz z jednym adresem IP serwera. Wiele stacji pod jednym adresem jest odpytywanych rzadziej, a nie równolegle.
• robots.txt: respektowany dla tokenu TunepingBot i dla *, osobno dla każdego schematu, hosta i portu. Jeden wyjątek: niektóre serwery strumieniowe mają wbudowany robots.txt, który zawiera dokładnie User-agent: * / Disallow: / i nic więcej. Taki goły domyślny plik serwera traktujemy jak „brak robots.txt”, bo nie napisał go operator stacji; grupa TunepingBot albo dowolna grupa * z czymkolwiek więcej niż ta jedna linia jest respektowana w całości. Błąd 5xx przy robots.txt traktujemy jak „disallow”, dopóki nie da się go znowu pobrać.
• Wycofanie: respektujemy 429 i 503 z Retry-After; po błędach połączenia odstępy rosną wykładniczo (1, 2, 4, 8 minut, do 24 godzin). Po 7 kolejnych dniach niepowodzeń odpytywanie kończy się na dobre.
• Blokady: jeśli wszystkie połączenia z danym adresem zaczynają przekraczać limit czasu, wstrzymujemy ten adres na godzinę i sami dostajemy alert. 401 lub 403 na URL strumienia albo dowolne wyzwanie zapory lub ochrony przed botami traktujemy jako trwałą rezygnację tego hosta.
• Połączenia: Connection: close, zwykłe HTTP/1.1, poprawnie zamykane pakietem FIN po odczytaniu bloku metadanych; 5 s na nawiązanie połączenia i 10 s łącznego limitu czasu; najwyżej 5 przekierowań.

Jak sprawdzić, że to naprawdę my

Żądania przychodzą z dwóch adresów z tabeli powyżej i znikąd indziej. Odwrotny DNS obu adresów to poller.tuneping.com, a ta nazwa w przód wskazuje na te same adresy, więc kontrola odwrotnego DNS potwierdzonego w przód zadziała. Wszystko, co podaje się za TunepingBot z innego adresu, to nie my; daj znać na [email protected]. Aktualna lista jest też opublikowana pod tuneping.com/bot/ips.json; o zmianach poinformujemy na tej stronie co najmniej tydzień przed ich wejściem w życie.

Jak zrezygnować

Wystarczy dowolny z trzech sposobów z góry tej strony. Respektujemy wszystkie trzy, rezygnacja jest trwała i zaczyna działać w ciągu 24 godzin (w praktyce harmonogram uwzględnia ją po kilku minutach). Bez pytań i bez uzasadniania. Działa też ogólna grupa User-agent: * w robots.txt, o ile nie jest to tylko jednolinijkowy plik domyślny dostarczany z oprogramowaniem serwera (zob. wyżej). Odpowiedź 401 lub 403 na URL strumienia albo wyzwanie zapory przed nim ma automatycznie ten sam skutek.

Rezygnacja usuwa stację z odpytywania, z API i z każdej publicznej strony oraz wpisuje ją na listę wykluczeń, którą harmonogram sprawdza przed każdym pojedynczym żądaniem. Jeśli później zechcesz wrócić, napisz na ten sam adres.

Co przechowujemy

Dla każdej stacji: bieżące i wcześniejsze tytuły dokładnie w opublikowanej postaci, czas, kiedy je zobaczyliśmy, oraz wpis stacji w katalogu (nazwa, URL strumienia, kraj, kodek). Na potrzeby grzecznego odpytywania i obsługi nadużyć prowadzimy też log własnych połączeń (czas, IP i port Twojego serwera, kod statusu, liczba bajtów) przez 7 dni, a w postaci zagregowanej godzinowo przez 30 dni, by na prośbę dokładnie odpowiedzieć, jakie żądania wysłaliśmy. Nie przechowujemy dźwięku, danych słuchaczy ani niczego osobowego. Bot nie zbiera danych osobowych; jedyne dane osobowe, które przetwarzamy, to dane kontaktowe osób, które do nas piszą (zob. prywatność).

Zgoda albo poprawka tego, co pokazujemy

Jeśli wolisz, żebyśmy czytali konkretny endpoint, albo publikujesz tytuły w miejscu, które przeoczyliśmy, napisz na [email protected], a przełączymy się. Jeśli nazwa lub dane Twojej stacji są błędne, ten sam adres to naprawi.

Skąd pochodzi lista stacji

Dane katalogu stacji z radio-browser.info, CC0 (dane społeczności w domenie publicznej). Bot nigdy nie wywołuje licznika kliknięć katalogu. Metadane muzyczne są dopasowywane do MusicBrainz (dane podstawowe CC0).

Kontakt i nadużycia

• Operatorzy stacji, rezygnacje, poprawki: [email protected]
• Zgłoszenia nadużyć: [email protected]
• Wszystko inne: [email protected]

Czytamy te skrzynki codziennie i staramy się potwierdzić odbiór w ciągu 24 godzin. Dane operatora są na stronie noty prawnej.

Historia zmian