RMP

Rend un article de blog RideMyPark en entier : titre, chapô, corps, auteur, date de publication, étiquettes et lien public. Paramètres : - slug (string, obligatoire, 1 à 200 caractères) : identifiant lisible de l'article. - locale ('fr' | 'en') : langue demandée, défaut fr. - response_format ('markdown' | 'json') : défaut markdown. Rend : titre, chapô, corps HTML de l'article, auteur, catégorie, étiquettes, date de publication ISO, image de couverture, langue d'origine (content_lang), langue servie (served_lang) et lien public. Limites connues des données : - le corps peut être long ; la réponse est plafonnée en taille et le dit quand elle a été tronquée ; - un article sans traduction dans la langue demandée est rendu dans sa langue d'origine (served_lang le dit) ; - un brouillon n'est jamais rendu, même avec le bon slug. Erreurs : - « Aucun article … » quand le slug n'existe pas ou n'est pas publié : le reprendre d'un résultat de recherche d'articles.

ridemypark_get_blog_article

Cherche parmi les articles PUBLIÉS du blog RideMyPark : guides, tests de matériel, portraits, actualités des spots. Sert à répondre à « avez-vous un guide pour débuter le skate ? » ou « qu'avez-vous écrit sur les pumptracks ? ». Paramètres : - query (string, 2 à 120 caractères) : mots-clés cherchés dans le titre et le chapô, dans la langue d'origine de l'article ET dans sa traduction. Chaque mot doit apparaître ; casse et accents ignorés. - tag (string, 1 à 60 caractères) : étiquette éditoriale exacte ; casse et accents ignorés. - category (string, 1 à 80 caractères) : catégorie exacte, casse comprise, dans la langue d'origine de l'article. Un résultat servi en traduction (served_lang ≠ content_lang) montre sa catégorie traduite : elle ne filtre pas. - locale ('fr' | 'en') : langue des titres et chapôs rendus, défaut fr. - limit (number 1-50, défaut 20), offset (number 0-5000, multiple de limit) : pagination. - response_format ('markdown' | 'json') : défaut markdown. Rend pour chaque article : titre, slug, chapô, catégorie, étiquettes, date de publication ISO, image de couverture, langue d'origine (content_lang), langue servie (served_lang) et lien public. Plus : total (le nombre d'articles qui répondent au filtre), page et per_page appliqués. Le corps complet s'obtient avec ridemypark_get_blog_article. Limites connues des données : - seuls les articles au statut « publié » sont rendus : un brouillon n'apparaît jamais ; - tri : le plus récemment publié en tête ; - le catalogue éditorial est modeste, une recherche vide est fréquente ; - la traduction n'existe que sur une partie des articles : sans elle, titre et chapô restent dans la langue d'origine. Erreurs : - « offset doit être un multiple de limit » : reprendre avec offset = 0, limit, 2×limit… - Aucun résultat : retirer l'étiquette ou la catégorie, ou garder un seul mot-clé.

ridemypark_search_blog

Cherche les boutiques du catalogue public RideMyPark : skateshops, magasins de vélo, ateliers et locations. Les résultats sont des fiches de l’univers shops, avec un lien /shops/<slug>. Paramètres : - near (string, 3 à 120 caractères) : lieu autour duquel chercher. Sinon latitude + longitude, en degrés décimaux. Ces deux modes ne se combinent pas. - radius_km (number > 0, maximum 200, défaut 25) : rayon autour du point de recherche. Sans point, aucun rayon n’est appliqué. - country (string, 2 à 80 caractères), region, city (string, 1 à 80 caractères) : slugs rendus par ridemypark_browse_geography. - query (string, 2 à 120 caractères) : mot-clé dans le titre, la description ou l’adresse. - limit (integer 1-50, défaut 10), page (integer 1-20, défaut 1) : pagination. - response_format ('markdown' | 'json') : défaut markdown. Rend : shops (id, title, slug, url, adresse, coordonnées, photo et site web quand renseignés), page, total_matched, has_more et notes. origin et radius_km sont présents si la recherche est centrée sur un lieu. Le slug ou l’id permet de lire la fiche avec ridemypark_get_shop. Limites : les fiches peuvent être incomplètes ou anciennes. Aucun stock, prix ou disponibilité de produit. Si une réponse amont contient un autre univers, ces fiches sont écartées, le total est omis et la pagination s’arrête avec une note. Erreurs : lieu introuvable, coordonnées incomplètes ou modes de localisation combinés. Aucun résultat : élargir le rayon ou retirer un filtre.

ridemypark_search_shops

Cherche des spots de skate, BMX, trottinette et roller dans le catalogue public RideMyPark : plus de 30 000 fiches dans un catalogue mondial. La couverture varie selon les pays et les villes. Sert à répondre à « trouve-moi un skatepark avec un bowl près de Lyon » ou « où faire du BMX à Bordeaux ». Paramètres : - near (string) : nom du lieu, géocodé automatiquement (« Lyon », « Bordeaux »). Sinon latitude + longitude. - radius_km (number) : rayon en km, défaut 25, maximum 200. - discipline ('skate' | 'bmx' | 'scooter' | 'roller') : sélectionne les spots dont les modules conviennent à cette pratique. - modules (string[]) : modules voulus en langage naturel (« bowl », « des rails », « escaliers »). Un spot suffit s'il en a UN. - match_all_modules (boolean) : true pour exiger TOUS les modules demandés. - spot_type ('street' | 'skatepark' | 'pumptrack') : nature du spot. - indoor (boolean) : true = couvert, false = extérieur, omis = les deux. - min_rating (number 0-5) : note minimale. Écarte les spots sans avis, qui sont la majorité. - query (string) : mot-clé dans le nom, la description ou l'adresse. - limit (number 1-50, défaut 10), offset (number 0-500) : pagination. - response_format ('markdown' | 'json') : défaut markdown. Rend pour chaque spot : titre, adresse, distance au point de recherche, type, modules, photo, lien de la fiche, et le slug à passer à ridemypark_get_spot. Limite connue : RideMyPark n'enregistre pas la discipline spot par spot. Le filtre discipline s'appuie sur les modules présents. C'est une approximation, et la réponse le dit. Erreurs : - Rien trouvé pour un lieu non géocodable : réessaie avec un nom de ville simple. - Aucun résultat : élargis radius_km ou retire un filtre.

ridemypark_search_spots

Rend les compteurs vitrine publics de RideMyPark : nombre de spots référencés, nombre de riders inscrits, nombre de villes couvertes. Sert à répondre à « c'est gros, RideMyPark ? » avec les chiffres affichés sur la page d'accueil, plutôt qu'avec une estimation. Paramètres : - response_format ('markdown' | 'json') : défaut markdown. Rend : data.spots (spots référencés), data.riders (riders inscrits) et data.cities (villes couvertes). Aucune date de calcul n'est rendue. Limites connues des données : - ce sont les compteurs VITRINE, mis en cache côté API : ils peuvent avoir quelques heures de retard ; - le compte de spots exclut les fiches fermées et archivées, contrairement à un total brut de base ; - aucun chiffre de fréquentation, de trafic ni de revenu n'est exposé ici. Erreurs : - Service momentanément saturé : réessayer dans un instant.

ridemypark_get_platform_stats

Rend la fiche complète d'un spot RideMyPark : où il est, ses modules, sa note, ses horaires, sa photo et le lien vers sa page publique. Paramètres : - slug (string) : identifiant lisible du spot, tel que rendu par ridemypark_search_spots (« place-louis-pradel-spot »). - id (number) : identifiant numérique, à défaut de slug. - response_format ('markdown' | 'json') : défaut markdown. Rend : titre, type (street / skatepark / pumptrack), adresse et ville, coordonnées, couvert ou extérieur, liste des modules, note sur 5 AVEC son nombre d'avis, horaires d'ouverture avec fuseau quand ils sont saisis, photo, galerie, réseaux sociaux, lien de la fiche. À savoir sur les données : - la note est absente sur la plupart des fiches ; l'outil dit « pas encore notée » plutôt que de rendre 0 ; - quand elle existe, elle repose presque toujours sur UN seul avis — le compte est rendu avec la note, ne la présente pas comme un consensus ; - les horaires ne sont saisis que sur les spots gérés (skateparks indoor surtout) ; un spot en accès libre n'en a pas ; - une fiche sans photo ne rend aucune URL, jamais l'image bouchon du site ; - un spot FERMÉ (moderation_status « closed », plus accessible) ou ARCHIVÉ (« archived », n'existe plus) reste lisible par son slug ou son id : la réponse le dit en tête. La recherche ne rend jamais ces spots. Erreurs : - « Aucun spot … » quand le slug n'existe pas : le reprendre d'un résultat de ridemypark_search_spots.

ridemypark_get_spot

Rend la fiche publique complète d'un événement RideMyPark : de quoi il s'agit, où et quand il a lieu, et le lien vers sa page. Un événement est une fiche du catalogue, servie par la même route qu'un spot ; cet outil vérifie que la fiche demandée appartient bien à l'univers des événements. Paramètres : - slug (string, 1 à 200 caractères) : identifiant lisible de l'événement. - id (number entier positif) : identifiant numérique, à défaut de slug. - response_format ('markdown' | 'json') : défaut markdown. Rend : titre, description, toutes les occurrences datées au format ISO (champ dates) et celles encore à venir (champ future_dates), adresse et ville, coordonnées, catégories, photo et galerie, lien source (website : le « Site web » de la page), réseaux sociaux (links), état de la fiche, date de dernière mise à jour, lien de la page publique. Limites connues des données : - une fiche d'événement peut n'avoir AUCUNE date saisie : les listes d'occurrences sont alors vides, et c'est la description qui porte l'information ; - les occurrences passées restent dans le champ dates : c'est future_dates qui dit ce qui reste à venir ; - la description est du texte libre saisi par l'organisateur, et la fiche peut ne plus être à jour à l'approche de la date ; - le nombre de participants et la liste des personnes présentes n'existent pas sur une fiche d'événement : cet outil n'en rend jamais. Erreurs : - « Aucun événement … » quand le slug n'existe pas : le reprendre d'un résultat de ridemypark_list_events. - « Cette fiche n'est pas un événement » quand le slug désigne un spot ou une boutique : l'erreur indique l'outil qui sert cet univers.

ridemypark_get_event

Rend la fiche publique d’une boutique du catalogue RideMyPark. Paramètres : - slug (string, 1 à 200 caractères) ou id (integer > 0) : fournir exactement un identifiant rendu par ridemypark_search_shops. - response_format ('markdown' | 'json') : défaut markdown. Rend : id, title, slug, url, gallery, links ; description, adresse, lieu, coordonnées, site web, téléphone, horaires, fuseau horaire, photo, état de modération et date de mise à jour quand renseignés. Les horaires sont ceux de la fiche, sans garantie d’ouverture en temps réel. Limites : les données peuvent être incomplètes ou anciennes. Aucun stock, prix, marque disponible ou achat. Une fiche de spot ou d’événement est refusée. Erreurs : identifiant absent, ambigu ou inconnu, ou fiche d’un autre univers.

ridemypark_get_shop

Répond oui ou non pour CE SOIR autour d'un point, et nomme les spots praticables les plus proches. C'est la question d'un rider en fin de journée, pas un bulletin météo. Le verdict est calculé par l'API RideMyPark, jamais ici : ce serveur ne fait que traduire la question en coordonnées et la réponse en phrases. Paramètres : - near (string, 1 à 200 caractères) : nom d'un lieu, géocodé avant la recherche ; - latitude + longitude (number) : le point directement, les deux ensemble ; - response_format ('markdown' | 'json') : défaut markdown. near OU le couple latitude/longitude est obligatoire. Rend : le verdict ('yes' | 'no'), la soirée couverte (date, heures locales, fuseau), le motif d'un non ('rain', 'closed', 'no-spots', 'no-weather'), et jusqu'à trois spots avec leur créneau praticable ou ce qui les en empêche. Ce que la réponse VÉRIFIE, et ce qu'elle ignore : - SEC : la probabilité de précipitation heure par heure sur la soirée, pas la moyenne du jour ; - COUVERT : un spot de catégorie indoor est considéré à l'abri de la pluie ; - OUVERT : les horaires déclarés de la fiche ; un spot qui n'en déclare aucun est considéré ouvert 24 h/24 ; - ÉCLAIRAGE : il n'entre PAS dans la réponse. La nuit ne bloque aucun spot : c'est au rider de savoir si son spot est éclairé. Autres limites connues : - le point est arrondi à environ 1 km, et seuls les spots les plus proches sont interrogés : la réponse porte sur une poignée de spots, pas sur tout le rayon (le champ 'scanned' dit combien) ; - la météo vient d'un fournisseur tiers, mise en cache côté API : elle peut avoir une demi-heure de décalage, et jusqu'à 6 h quand ce fournisseur est en panne ; - le sol peut rester mouillé longtemps après la pluie — « sec » parle du ciel, pas du béton ; - passé la fin de soirée, la réponse porte sur DEMAIN soir ('tomorrow' vaut alors vrai). Erreurs : - « Rien trouvé pour … » quand le lieu n'est pas reconnu : essaie un nom de ville simple, ou donne latitude et longitude. - Outil indisponible : la météo n'est pas configurée côté serveur, il n'y a pas de réponse à donner.

ridemypark_can_i_ride_tonight

Rend la météo courante et la prévision des prochains jours aux coordonnées d'un spot RideMyPark, pour savoir si la session tient. Paramètres : - slug (string, obligatoire, 1 à 200 caractères) : slug du spot. - response_format ('markdown' | 'json') : défaut markdown. Rend : mode, puis selon ce mode : - current (le cas courant) : current (température et ressenti en °C, vent en km/h, condition, jour ou nuit) et days, la prévision par jour (température min et max, condition, probabilité de pluie en %) ; - event (fiche d'événement datée) : event_date et event_day, la prévision du jour de l'événement ; - pending (événement trop lointain) : event_date et available_from, la date à partir de laquelle la prévision existera. Toujours : observed_at (horodatage de la mesure) et provider. condition vaut clear, partly-cloudy, cloudy, overcast, fog, drizzle, rain, heavy-rain, sleet, snow ou thunder. Limites connues des données : - la météo vient d'un fournisseur tiers appelé aux coordonnées de la fiche : un spot mal géocodé rend la météo du mauvais endroit ; - un spot COUVERT rend quand même une météo extérieure — elle ne dit rien de la praticabilité d'un park indoor ; - la donnée est mise en cache côté API et peut avoir un décalage de l'ordre de l'heure. Quand le fournisseur tiers est en panne, l'API ressert le dernier relevé connu, jusqu'à 6 h d'âge : observed_at dit cet âge, et passé une heure current est absent (seuls les jours restent) ; - la pluie est une PROBABILITÉ par jour, pas une quantité ; - le sol peut rester mouillé longtemps après la pluie : la prévision ne dit pas si le spot est sec. Erreurs : - « Pas de météo … » quand le slug n'existe pas, quand la fiche n'a pas de coordonnées ou n'est pas un spot ni un événement (une boutique), ou quand la météo n'est pas activée sur le serveur. - Météo indisponible : le fournisseur tiers n'a pas répondu, réessayer plus tard.

ridemypark_get_spot_weather