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

Vous avez trouvé TunepingBot dans vos journaux. Voici tout ce qu’il fait.

Il lit le titre public « en cours de diffusion » de votre station toutes les 20 à 60 secondes, quelques KB à la fois, et ne touche jamais à l’audio. Si vous préférez qu’il s’abstienne, n’importe laquelle des trois exclusions ci-dessous fonctionne, définitivement, sous 24 heures. Sans poser de questions.

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

User-agent: TunepingBot
Disallow: /

X-Robots-Tag: noindex

L’essentiel

Qui nous sommes

Tuneping est un petit service qui tient un index en direct de ce que diffusent les stations de radio en ligne, afin que les auditeurs et les développeurs puissent chercher une chanson sur l’ensemble des stations, consulter l’historique de diffusion d’une station, ou être prévenus quand une chanson de leur liste de souhaits commence. L’index est construit entièrement à partir des métadonnées de titre que les stations publient déjà pour chaque auditeur. Le serveur ne traite que des métadonnées ; il ne stocke, ne relaie et ne redistribue jamais d’audio.

Nous préférons l’endpoint d’état chaque fois qu’une station en a un, car il vous coûte quelques centaines d’octets au lieu d’une courte rafale d’audio.

À quelle fréquence, et comment il se comporte

• Intervalle : toutes les 20 s pour les endpoints d’état peu coûteux, toutes les 60 s pour les métadonnées dans le flux (30 s pour un petit nombre de stations qu’un utilisateur a explicitement demandé à suivre). Les pages d’état volumineuses par rapport aux stations qu’elles servent sont interrogées proportionnellement moins souvent, de sorte qu’une station ne coûte jamais plus d’octets par minute qu’une vérification dans le flux. Les stations dont le titre n’a pas changé depuis 30 minutes passent à une interrogation toutes les 5 minutes. Les intervalles varient de plus ou moins 10 % pour que les stations d’un même serveur ne soient pas sollicitées en même temps.
• Concurrence : au plus 2 connexions ouvertes à la fois vers une même adresse IP de serveur. Plusieurs stations derrière une même adresse sont interrogées moins souvent, pas en parallèle.
• robots.txt : respecté pour le jeton TunepingBot et pour *, par schéma, hôte et port. Une exception : plusieurs serveurs de streaming livrent un robots.txt intégré qui contient exactement User-agent: * / Disallow: / et rien d’autre. Nous traitons ce réglage par défaut du serveur comme « pas de robots.txt », car ce n’est pas l’opérateur de la station qui l’a écrit ; un groupe TunepingBot, ou tout groupe * contenant plus que cette seule ligne, est respecté intégralement. Une erreur 5xx sur robots.txt est traitée comme « disallow » jusqu’à ce qu’il puisse être récupéré à nouveau.
• Temporisation : 429 et 503 avec Retry-After sont respectés ; les erreurs de connexion entraînent une temporisation exponentielle (1, 2, 4, 8 minutes, jusqu’à 24 heures). Après 7 jours consécutifs d’échec, l’interrogation s’arrête définitivement.
• Blocages : si toutes les connexions vers une adresse commencent à expirer, nous mettons cette adresse en pause pendant une heure et nous nous envoyons une alerte. Un 401 ou un 403 sur l’URL du flux, ou toute vérification de pare-feu ou anti-bot, est traité comme une exclusion définitive de cet hôte.
• Connexions : Connection: close, HTTP/1.1 simple, fermée proprement par un FIN une fois le bloc de métadonnées lu ; délai de connexion de 5 s et délai total de 10 s ; redirections suivies sur 5 sauts au plus.

Comment vérifier que c’est bien nous

Les requêtes proviennent des deux adresses du tableau ci-dessus et de nulle part ailleurs. Le DNS inverse des deux adresses est poller.tuneping.com, et ce nom se résout dans l’autre sens vers les mêmes adresses : une vérification de DNS inverse confirmée dans les deux sens fonctionne donc. Tout ce qui se présente comme TunepingBot depuis une autre adresse n’est pas nous ; merci de le signaler à [email protected]. La liste actuelle est aussi publiée sur tuneping.com/bot/ips.json ; nous annoncerons tout changement sur cette page au moins une semaine avant qu’il ne prenne effet.

Comment vous exclure

N’importe laquelle des trois méthodes en haut de cette page suffit. Toutes trois sont respectées, les exclusions sont définitives et prennent effet sous 24 heures (en pratique, le planificateur les prend en compte en quelques minutes). Sans questions, sans justification. Un groupe général User-agent: * dans robots.txt fonctionne aussi, tant qu’il ne s’agit pas seulement de la ligne par défaut livrée par votre logiciel serveur (voir plus haut). Renvoyer 401 ou 403 sur l’URL du flux, ou placer une vérification de pare-feu devant, a automatiquement le même effet.

Une exclusion retire la station de l’interrogation, de l’API et de toute page publique, et l’inscrit sur une liste de suppression que le planificateur consulte avant chaque requête. Si vous souhaitez revenir plus tard, écrivez à la même adresse.

Ce que nous stockons

Pour chaque station : les chaînes de titre actuelles et passées exactement telles que publiées, l’horodatage auquel nous les avons vues, et la fiche de la station dans l’annuaire (nom, URL du flux, pays, codec). Par politesse et pour traiter les abus, nous conservons aussi un journal de nos propres connexions (horodatage, IP et port de votre serveur, code de statut, nombre d’octets) pendant 7 jours, agrégé par heure pendant 30 jours, afin de pouvoir vous dire précisément quelles requêtes nous avons faites si vous le demandez. Nous ne stockons ni audio, ni données d’auditeurs, ni quoi que ce soit de personnel. Le bot ne collecte aucune donnée personnelle ; les seules données personnelles que nous traitons sont les coordonnées des personnes qui nous écrivent (voir la confidentialité).

Nous indiquer où lire, ou corriger ce que nous affichons

Si vous préférez que nous lisions un endpoint particulier, ou si vous publiez des titres à un endroit qui nous a échappé, dites-le à [email protected] et nous changerons. Si le nom ou les détails de votre station sont faux, la même adresse permet de les corriger.

D’où vient la liste des stations

Données de l’annuaire des stations issues de radio-browser.info, CC0 (données communautaires du domaine public). Le bot n’appelle jamais le compteur de clics de l’annuaire. Les métadonnées musicales sont rapprochées de MusicBrainz (données de base CC0).

Contact et abus

• Opérateurs de stations, exclusions, corrections : [email protected]
• Signalements d’abus : [email protected]
• Tout le reste : [email protected]

Nous lisons ces boîtes tous les jours et visons un accusé de réception sous 24 heures. Les coordonnées de l’exploitant figurent sur la page des mentions légales.

Historique des versions