Erreur action {{trail ...}} : La page MenuAideCEL ne semble pas exister !
Flux de syndication du CEL
Ci-dessous sont indiquées les liens des flux de syndication du CEL pour les observations et les images.Un flux Multicriteres existe pour les deux ressources.
Les urls :
- https://api.tela-botanica.org/service:cel:CelSyndicationImage/MultiCriteres/atom?critere1=valeur1&critere2=valeur2
- https://api.tela-botanica.org/service:cel:CelSyndicationObservation/MultiCriteres/atom?critere1=valeur1&critere2=valeur2
- 'utilisateur' => l'adresse mail de l'utilisateur,
- 'commune' => le nom de la commune,
- 'dept' => le code du département,
- 'taxon' => le nom scientifique,
- 'commentaire' ,
- 'date' => la date d'observation,
- 'tag' ou 'projet' => les mots-clés pour décrire l'image ou l'observation (peut prendre plusieurs valeurs séparés par OU ou ET),
- 'recherche' => cherche le terme dans le nom retenu, le nom sélectionné, le nom ou le code du lieu d'observation ou l'utilisateur.
Observations
Les flux disponibles :- par défaut : fournit les informations détaillées sur les observations publiques.
- multicritères : voir ci-dessus.
Exemples :
- https://api.tela-botanica.org/service:cel:CelSyndicationObservation/par-defaut/atom
- https://api.tela-botanica.org/service:cel:CelSyndicationObservation/multicriteres/atom?projet=Flore de Coste
- https://api.tela-botanica.org/service:cel:CelSyndicationObservation/multicriteres/atom?commune=Montpellier
Deux services complémentaires permettent de récupérer la liste des flux :
- liste des flux : https://api.tela-botanica.org/service:cel:CelSyndicationObservation/liste-des-flux
- opml : https://api.tela-botanica.org/service:cel:CelSyndicationObservation/opml
Images
Les flux disponibles- simple : fournit uniquement l'url des images liées aux observations dans le format indiqué (S,M,L)
- complet : fournit les informations détaillées sur l'image et l'observation liée pour les images liées aux observations.
- multicritères : voir ci-dessus.
Exemples :
- https://api.tela-botanica.org/service:cel:CelSyndicationImage/simple/atom/format : format = S | M | L (voir les formats disponibles)
- https://api.tela-botanica.org/service:cel:CelSyndicationImage/complet/atom
- https://api.tela-botanica.org/eflore/cel2/jrest/CelSyndicationImage/multicriteres/atom?tag=plantnet
- https://api.tela-botanica.org/eflore/cel2/jrest/CelSyndicationImage/multicriteres/atom?tag=plantnetETfeuille
Deux services complémentaires permettent de récupérer la liste des flux :
- liste des flux : https://api.tela-botanica.org/service:cel:CelSyndicationImage/liste-des-flux
- opml : https://api.tela-botanica.org/service:cel:CelSyndicationImage/opml
Notes
Pour chacune des urls ci-dessus vous pouvez remplacer "atom" par "rss1" ou "rss2" si votre lecteur de flux connaît pas le format atom.Par défaut, les 150 derniers éléments seront retournés mais vous pouvez modifier cette valeur en ajoutant le paramètre limit aux urls. Comme ceci :
https://api.tela-botanica.org/service:cel:CelSyndicationObservation/par-defaut/atom?limit=50
Il est possible de naviguer dans les résultats des flux en utilisant le paramètre start aux urls. Si vous indiqué start=100, vous afficherez les 150 derniers résultats à partir du 100ème plus récent. Par exemple :
https://api.tela-botanica.org/service:cel:CelSyndicationImage/complet/atom?start=100
De la même façon, si vous êtes administrateur, il est possible d'ajouter le paramètre admin avec la valeur 1 afin d'afficher des données complémentaires. Par exemple :
https://api.tela-botanica.org/service:cel:CelSyndicationObservation/par-defaut/atom?limit=200&admin=1
Enfin, concernant les deux services complémentaires permettant de récupérer la liste des flux :
- liste des flux : fournit des informations sur les flux disponibles au format JSON.
- opml : fournit les flux aux format Atom sous forme de fichier xml OPML importable dans votre lecteur de flux.
Propositions d'amélioration
- Avoir seulement une url et plusieurs critères permettant de filtre le flux. Ces critères doivent être sous forme de paramètre de requête d'URL (après le ?) ce qui permet d'en choisir un seul ou plusieurs au choix.
- Pouvoir filtrer sur un ou plrs mots-clés avec la syntaxe suivante :
- motcle1,motcle2 : pour les obs ou images ayant le mot-clé "motcle1" ou le mot-clé "motcle2".
- motcle1+motcle2 : pour les obs ou images ayant le mot-clé "motcle1" et le mot-clé "motcle2".
- motcle1+motcle2,motcle3 : : pour les obs ou images ayant le mot-clé "motcle1" et le mot-clé "motcle2" ou seulement le mot-clé "motcle3".