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 :
Ils prennent en critères :
- '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 :
Deux services complémentaires permettent de récupérer la liste des flux :
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 :
Deux services complémentaires permettent de récupérer la liste des flux :
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".