L'API Vente et achat de produits phytopharmaceutiques (PPP) donne accès aux données ouvertes de la BNV-D Traçabilité opérée par l'Office français de la biodiversité. Cette banque recueille les données déclaratives permettant d’améliorer la traçabilité des ventes de PPP.
Vente et achat de produits phytopharmaceutiques New
L'API Vente et achat de produits phytopharmaceutiques diffuse les données ouvertes générées à partir des déclarations annuelles des distributeurs agréés pour la vente de ces produits. Ces données décrivent les quantités de produits et de substances actives vendues ou achetées sur le territoire national (depuis 2008 pour les ventes et 2013 pour les achats). Collectées par les agences de l'eau afin d’établir le montant de la redevance pour pollutions diffuses, ces données sont ensuite bancarisées par l'Office français de la biodiversité dans la Banque Nationale des Ventes de produits phytopharmaceutiques par les Distributeurs agréés (BNV-D) Traçabilité.
-
Présentation
-
Derniers changements
- 11/2024 : Mise en ligne de la version 1
-
Exposition des données
Les formats supportés sont : JSON et CSV.
-
Accessibilité
L'API Vente et achat de produits phytopharmaceutiques est conforme au standard OpenAPI 3.
L'API est accessible :
- en http : http://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/ventes/substances?code_substance=1952&type_territoire=National&size=20
- en https : https://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/ventes/substances?code_substance=1796&type_territoire=National&size=250
Pour gérer le cross-domain, l'API supporte les protocoles :
- CORS (Cross Origin Resource Sharing)
- JSONP avec le paramètre callback pour les anciens navigateurs : https://hubeau.eaufrance.fr/api/1/vente_achat_phyto/achats/substances?annee_min=2020&fonction=Herbicide,type_territoire=D%C3%A9partement&code_territoire=80&size=2000&callback=jquery12
-
Pagination
Chaque page renvoie un nombre de résultats égal au paramètre size.
L'API Vente et achat de produits phytopharmaceutiques utilise un type de pagination non séquentiel qui permet de sauter d'une page à l'autre de résultats dans n'importe quel ordre. En contre-partie, la profondeur d'accès aux résultats est limitée.
Paramètres
- page : le numéro de page
- size : la taille de la page
Attributs
- Les attributs prev et next (définis à null si il n'y a pas de page précédente et/ou suivante) sont disponibles dans l'URL de la réponse pour éviter d'avoir à calculer les pages précédentes et/ou suivantes
- L'attribut first permet d'accéder à la première page des résultats,
- L'attribut last permet d'accéder à la dernière page des résultats,
- L'attribut count permet de compter le nombre total de résultats,
- L'attribut data permet d'accéder aux résultats sous forme de liste.
Un tutoriel sur l'API Qualité des cours d'eau explique, dans la partie Taille des pages de réponse, la mise en oeuvre pratique de la pagination à l'aide d'un cas concret.
Enfin, des exemples de code en Python, R et php sont disponibles dans la partie Exemples de la page de contribution GitHub de Hub'Eau. -
Limitations
Pagination
- Taille de page : les résultats sont paginés avec une valeur par défaut et une valeur maximum de taille de page pour chaque opération. Cette valeur est indiquée dans les commentaires de l'opération. Par exemple : "taille de page par défaut : 5000, taille max de la page : 20000."
- Profondeur d'accès aux résultats : la profondeur d'accès aux résultats (numéro de la page * nombre maximum de résultats dans une page) est limitée à 20 000 enregistrements.
Taille de l'URL
La longueur maximale d'une URL est de 2 083 caractères, la requête est bloquée si la limite de longueur est dépassée.
-
Opérations
- Achats
- Produits
- Substances
- Ventes
- Produits
- Substances
- Achats
-
Exemple
- Achats de substances herbicides (« Herbicide » ou « Herbicide – Antimousse ») depuis 2020 dans les Hauts-de-France (départements Aisne (02) ; Nord (59) ; Oise (60) ; Pas-de-Calais (62) ; Somme (80))
Json : https://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/achats/substances?annee_min=2020&fonction=Herbicide,Herbicide – Antimousse&type_territoire=Département&code_territoire=02,59,60,62,80&size=20
CSV : https://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/achats/substances.csv?annee_min=2020&fonction=Herbicide,Herbicide – Antimousse&type_territoire=Département&code_territoire=02,59,60,62,80&size=20
- Ventes de substances classées CMR selon le dispositif RPD depuis 2019 France entière
Json : https://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/ventes/substances?annee_min=2015&classification=CMR&type_territoire=National&size=20
CSV : https://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/ventes/substances.csv?annee_min=2015&classification=CMR&type_territoire=National&size=20 - Achats de produits non EAJ à l’étranger depuis 2015
Json : https://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/achats/produits?achat_etranger=Oui&annee_min=2015&eaj=Non&type_territoire=National&size=20
CSV : https://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/achats/produits.csv?achat_etranger=Oui&annee_min=2015&eaj=Non&type_territoire=National&size=20
- Ventes des AMM 2090160, 2120034, 2150140, 2090093, 9600390, 2120143, 2010262, 2010415, 9800294, 9400162 (remarque : il s’agit des 10 AMM comportant le + de QSA glyphosate vendue depuis 2008) vendus depuis 2008
Json : https://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/ventes/substances?annee_min=2008&type_territoire=National&amm=2090160,2120034,2150140,2090093,9600390,2120143,2010262,2010415,9800294,9400162&size=20
CSV : https://hubeau.eaufrance.fr/api/v1/vente_achat_phyto/ventes/substances.csv?annee_min=2008&type_territoire=National&amm=2090160,2120034,2150140,2090093,9600390,2120143,2010262,2010415,9800294,9400162&size=20
- Achats de substances herbicides (« Herbicide » ou « Herbicide – Antimousse ») depuis 2020 dans les Hauts-de-France (départements Aisne (02) ; Nord (59) ; Oise (60) ; Pas-de-Calais (62) ; Somme (80))
swagger