ÉCHANTILLON GRATUIT DE L'API TURF.BZH : 7 JOURNÉES, DU JEUDI 1ER OCTOBRE 2026 AU MERCREDI 7 OCTOBRE 2026
========================================================================

Ces fichiers ont été téléchargés par l'API de turf.bzh en production le 16/10/2026 à 09:39.
Rien n'a été fabriqué ni retouché : ce sont les réponses de l'API, telles quelles.
Le zip contient 7 journées complètes, soit 403 courses.
Il sert à vérifier la structure des fichiers et leur intégration dans votre logiciel.
Usage : évaluation personnelle. L'usage commercial et la redistribution des données
ne sont pas permis (CGV de turf.bzh, article 18).

LES FICHIERS
------------------------------------------------------------------------
schema.json
    Le dictionnaire des champs de l'API, avec le taux de remplissage mesuré chaque nuit.
manifest.json, journal.txt
    Chaque fichier avec son adresse d'origine et son empreinte SHA-256 ; chaque appel avec
    son code HTTP. Les échecs y figurent : rien n'est caché.
AAAA-MM-JJ/ (un dossier par journée)
    partants.json et partants.csv : tous les partants, tous les champs (champs=tout).
        Le CSV a pour séparateur le point-virgule et s'ouvre dans Excel.
    resultats.json : les arrivées complètes des courses de la journée.
    rapports.json et rapports.csv : les rapports définitifs des deux masses PMU.
    cotes_historique.csv : tous les relevés de cote de la journée, une ligne par relevé et
        par partant (date;code_course;t;heure;num;cote;cote_ref).
    cotes_historique/RxCy.json : la série de cotes de chaque course, avec l'hippodrome,
        l'heure de départ programmée, le nombre de relevés, le premier et le dernier.
partants.csv, rapports.csv, cotes_historique.csv (à la racine)
    Les journées mises bout à bout, avec un seul en-tête, pour charger la période d'un coup.

LES JOURNÉES
------------------------------------------------------------------------
2026-10-01 : 53 courses, séries de cotes 53/53
2026-10-02 : 48 courses, séries de cotes 48/48
2026-10-03 : 79 courses, séries de cotes 79/79
2026-10-04 : 65 courses, séries de cotes 65/65
2026-10-05 : 57 courses, séries de cotes 53/57 (sans série : R8C1, R8C5, R8C7, R8C8)
2026-10-06 : 44 courses, séries de cotes 44/44
2026-10-07 : 57 courses, séries de cotes 57/57

CE QU'IL FAUT SAVOIR AVANT DE S'EN SERVIR
------------------------------------------------------------------------
1. Les cotes. L'historique donne la cote Simple Gagnant du flux PMU, relevée par
   turf.bzh tout au long de la journée. 'cote' est la cote du moment, 'cote_ref' la cote
   de référence du matin. 't' est l'heure du relevé en secondes Unix, 'heure' la même en
   heure de Paris. La cote Simple Placé n'est pas relevée avant le départ : seuls les
   rapports définitifs au Simple Placé sont fournis (rapports.csv).
2. Une cote à 0 n'est pas une cote. Le PMU renvoie 0 tant que le marché n'est pas ouvert.
   Nous ne publions pas ce 0 : la cellule est vide, et un relevé où aucun partant n'a
   de cote n'apparaît pas.
3. Cadence des relevés. La collecte resserre l'intervalle à l'approche du départ,
   mais la finesse ne dépasse jamais la fréquence du collecteur, qui passe toutes les
   5 minutes : les toutes dernières minutes avant le départ sont couvertes par un ou
   deux relevés. Mesuré sur les Quinté+ du 27/07 au 05/09/2026 : une mesure toutes les
   30 à 35 minutes au-delà de 2 h, toutes les 15 minutes environ entre 2 h et 30 min,
   puis toutes les 5 à 10 minutes jusqu'au départ.
4. L'historique des cotes commence le 27/07/2026 et ne peut pas être rattrapé : le flux
   du PMU ne conserve pas la série, turf.bzh la relève au fil de la journée. Les courses
   sans série sont listées plus haut ; la réponse de l'API pour chacune est dans journal.txt.
5. Les rapports. Le PMU publie deux masses qui ne paient pas la même somme : 'en_ligne'
   et 'point_de_vente'. Le champ 'masse' les distingue, et les deux sont dans le fichier.
   'rapport_pour_1_euro' est le rapport tel que le PMU le publie, 'rapport_pour_la_mise_de_base'
   le montant encaissé pour la mise de base du pari ('mise_de_base'). Une ligne dont 'paye'
   vaut false est une formule proposée que personne n'a trouvée.
6. Les partants. 'Cote' est la cote de départ, mise à jour au rafraîchissement du lendemain
   matin. Un champ vide veut dire inconnu, jamais zéro. Les taux de remplissage de chaque
   champ, mesurés chaque nuit sur toute la base, sont dans schema.json.
7. Les six champs d'évolution du poids et de la valeur (delta_poids, delta_valeur,
   poids_prec, valeur_prec, date_prec, disc_prec) ne concernent que le galop et restent
   vides au trot.

POUR ALLER PLUS LOIN
------------------------------------------------------------------------
Documentation complète : https://www.turf.bzh/api-docs.php
Les mêmes appels, pour n'importe quelle date de la base (depuis février 2025) :
    GET /api/v1/journees/{date}/partants?champs=tout
    GET /api/v1/rapports?date={date}
    GET /api/v1/courses/{date}/{RxCy}/cotes/historique
Les exports mensuels de la base entière (CSV compressé) : GET /api/v1/exports
