Changements récents | Changements à venir
Liste des dernières modifications / évolutions techniques de la plateforme Apidae
- 1.46 – Mai 2023
#29062 [API] Prise en compte des traductions des Lieux dans les API
Les traductions des noms de lieux sont maintenant disponibles en API de lecture dans le nœud localisation.lieu.#17934 [API] Indexation du critère « gratuit »
Il est désormais possible d’effectuer des recherches en API de lecture sur les offres gratuites ou payantes.#27355 [API] Contrôles sur les dates mal formatées
De nouvelles vérifications sont mises en place sur la gestion des dates et des horaires en API d’écriture.
Les dates sont au format ISO 8601 : « 2012-06-27 », les horaires sont au format HH:MM:SS. - 1.43 – février 2023
[schemas] Modification d’une devise (CFP > XPF)
Le code international de la devise « Franc pacifique » est XPF, mais était noté CFP jusqu’ici sur le SIT (code local). Ce changement impacte les schemas, mais les valeurs saisies restent identiques (la devise est bien la même).
[schemas] Nouveaux jours fériés
Deux nouveaux jours fériés ont été ajoutés pour l’usage de Tahiti : l’enum pour le noeud dateSpecial a été enrichi de deux valeurs : ARRIVEE_EVANGILE et FETE_AUTONOMIE
- 1.4.63 JS – Décembre 2022
Enrichissement des API du Service de consentement
Les appels API du service de consentement filtraient la donnée de manière un peu trop drastique.
Certains identifiants de critères n’étaient pas présents et l’adresse de l’offre ne contenait qu’un seul champ.La position des nœuds ne change pas dans les API, mais de nouveaux identifiants seront disponibles.
Avant :
{ "type" : "EQUIPEMENT", "localisation" : { "adresse" : { "adresse1" : "Parc Technologique Clermont-Ferrand - La Pardieu" } }, "informationsEquipement" : { "activites" : [ { "elementReferenceType" : "EquipementActivite", "libelleFr" : "Sports cyclistes" }, { "elementReferenceType" : "EquipementActivite", "libelleFr" : "Itinéraire VTT" } ] } }Après :
{ "type" : "EQUIPEMENT", "localisation" : { "adresse" : { "adresse1" : "Parc Technologique Clermont-Ferrand - La Pardieu", "adresse2" : "7 ALLÉE PIERRE DE FERMAT", "adresse3" : "CS 50502", "codePostal" : "37260", "cedex" : "CEDEX", "etat" : "France", "commune" : { "id" : 14707, "code" : "37278", "nom" : "Villeperdue", "pays" : { "elementReferenceType" : "Pays", "id" : 532, "libelleFr" : "France", "ordre" : 78 }, "codePostal" : "37260" } } }, "informationsEquipement" : { "activites" : [ { "elementReferenceType" : "EquipementActivite", "id" : 3113, "libelleFr" : "Sports cyclistes", "ordre" : 44, "familleCritere" : { "elementReferenceType" : "FamilleCritere", "id" : 50, "libelleFr" : "Sports cyclistes", "ordre" : 136 } }, { "elementReferenceType" : "EquipementActivite", "id" : 3284, "libelleFr" : "Itinéraire VTT", "ordre" : 53, "description" : "Concerne les itinéraires de cross-country.\r\nLes randonnées avec accompagnateur sont à saisir en \"Activités\".", "familleCritere" : { "elementReferenceType" : "FamilleCritere", "id" : 50, "libelleFr" : "Sports cyclistes", "ordre" : 136 }, "parent" : { "elementReferenceType" : "EquipementActivite", "id" : 3113, "libelleFr" : "Sports cyclistes", "ordre" : 44 } } ] } } - 1.41 – Janvier 2023
API Membres : retrait du nœud « niveauDiffusion »
Suite à la mise en place du service de consentement et au retrait des développements sur l’Open Data, le nœud niveauDiffusion sera retiré des API Membres.
Les endpoints concernés sont les suivants :
– v002/membre/get-by-id
– v002/membre/get-membres/ - 1.39 – 8 novembre 2022
#26509 – retrait du champ descriptionTarif.periodes[].type
Ce champ n’était visible qu’en API et Exports, et ne pouvait pas être modifié côté IHM.
Il s’agissait d’un champ fantôme restant d’une ancienne version de l’application.
Il était en revanche obligatoire en écriture API : le champ a été retiré, mais sera toujours accepté par les API d’écriture (sans aucun traitement désormais).Le champ sera définitivement interdit dans un version à venir à partir de février 2023. Il conviendra donc de retirer ce champ de vos écritures, qui pourraient alors tomber en erreur.
Les schemas JSON ont été mis à jour en conséquence.
#25211 – API membres collaborateurs
Il est désormais possible de modifier les collaborateurs d’une offre dont l’utilisateur réalisant l’écriture API est propriétaire :
v002/collaborateurs (écriture)
v002/collaborateurs (lecture)#27052 (bugfix) – API consultation non mise à jour après écriture descriptifs privés par API
Le cache des offres dont les descriptifs privés avaient été modifiés par API n’était pas immédiatement invalidé, donnant l’impression que les informations n’avaient pas été enregistrées.
Les offres sont désormais immédiatement mises à jour sur les API de consultation, dès l’écriture de descriptifs privés par API.
- 1.38 – septembre 2022
#7276 – Dates de validité sur les descriptifs thématisés
Les descriptifs thématisés peuvent désormais être conditionnés à des dates de publication.
Dans tous les cas, les descriptifs continueront d’être envoyés dans les API et export : ils seront désormais accompagnés de 2 champs supplémentaires :– dateDisponibilite
– dateLimiteDePublicationPar défaut ces champs sont à null. Si une date est renseignée, il convient donc, côté exploitation (site web, brochure…) d’en tenir compte pour masquer le descriptif thématisé concerné.
- 1.36 – juin 2022
Lire et écrire dans le suivi enquêtes
Les enquêtes n’étaient jusque là consultable et modifiables que par IHM : désormais ces informations seront accessibles dans les API de lecture (dans un nouveau noeud enquete) et en écriture (en réutilisant le format de la lecture).
{ "type": "COMMERCE_ET_SERVICE", "enquete": { "enquetes": [ { "identifiant": 1659476, "annee": 2022, "retour": false, "titre": { "elementReferenceType": "EnqueteTitre", "id": 3934, "libelleFr": "Enquête annuelle", "libelleEn": "Annual survey", "ordre": 1 } }, ... ] } }Ajout des tarifs sur les types objets Commerces et Services
Par défaut, sur les commerces et services, les champs suivants possédaient jusqu’à présent toujours la même valeur :
descriptionTarif.gratuit=false
descriptionTarif.indicationTarif=PAYANTPar ailleurs, le champ
descriptionTarif.tarifsEnClairn’était pas présent sur ce type objet. Il n’était d’ailleurs pas possible de renseigner de tarifs sur les commerces et services en IHM.Les tarifs ont désormais été ajoutés sur le type objet, et les 3 champs ci-dessous prendront les valeurs fournies par l’utilisateur. Ces champs sont accessibles également en API d’écriture, comme sur les autres types objets.
Ajout des libellés des natures de liens
Jusqu’ici, seuls les noms techniques des natures des liens étaient présents dans l’API, les libellés (exemple : Est une étape de…) ont été ajoutés.
Avant "type": "ETAPE_PARCOURS","objetTouristique": {
"type": "PATRIMOINE_CULTUREL",
"id": 869653,Après "type": "ETAPE_PARCOURS","libelleFr": "Est une étape de ...","libelleEn": "Follows a section of...","objetTouristique": {
"type": "PATRIMOINE_CULTUREL",
"id": 869653,Suppression d’un champ obsolète dureeSejourMinimum
Ce champ était resté visible dans les API, bien qu’inaccessible en saisie. Il restait présent dans certains offres très anciennes, il a désormais été retiré.
API écriture
Validation des saisies de dates
Des erreurs de saisie pouvaient entrainer des dates incohérentes, qui étaient jusqu’ici acceptées par les API (20200-01-01, 0001-01-01, 9999-01-01…) : les dates seront désormais contrôlées au moment de l’écriture.
Seules les dates au formatYYYY-MM-DDseront désormais acceptées, et seulement si elles sont dans une plage de 2 ans avant / 10 ans après la date de l’écriture.Consulter la documentation sur les API d’écriture
Renvoi des critères interdits ignorés à l’écriture
Même lorsqu’une écriture est acceptée, certains critères ne sont pas pris en compte parce qu’interdits.
L’API retournera désormais la liste des critères interdits qui ont été retirés au moment de l’écriture, dans un nouveau noeudinformationsde la réponse.Consulter la documentation sur les API d’écriture
Demande de dépublication (masquage) d’offres
L’API d’écriture permet désormais de demander le masquage d’une offre.
Consulter la documentation sur les API d’écriture
Annulation de brouillons invalides
Jusqu’ici, si une écriture comportait une erreur bloquante, l’offre se retrouvait quand même en attente de validation (malgré le skipValidation) : elle se retrouvait donc verrouillée, en attendant une intervention de son propriétaire sur l’IHM.
Désormais, les développeurs pourront demander à ce qu’une écriture avec skipValidation, mais qui comporte une erreur bloquante, soit annulée automatiquement au lieu de rester en brouillon, grâce à une nouvelle option onValidationFail=CANCEL.Consulter la documentation sur les API d’écriture
Dates et actions d’expiration
L’API d’écriture permet désormais d’intervenir sur les dates et actions d’expiration, qui n’étaient jusqu’ici accessible que par IHM.
Comme pour les autres types de champs, l’écriture se fait en réutilisant le format de l’API de lecture.
{ "type": "HOTELLERIE", "id": 5901975, "expiration": { "dateExpiration": "2022-05-31", "expirationAction": "MASQUER_AUTOMATIQUEMENT" } }Les valeurs possibles pour expirationAction sont disponibles sur les schemas :
https://github.com/apidae-tourisme/apidae-sit-schemas/blob/main/v002/api/full/misc/expiration.schemaConsulter la documentation sur les dates et actions d’expiration
- septembre 2021 – API Exports utilisateurs/membres
API / Exports utilisateurs & membres
– Ajout de la notion de statut sur la consultation des utilisateurs (ACTIF, INACTIF)
– Ajout de la possibilité de filtrer sur le statut des utilisateurs
– Ajout de la notion de parrain sur la consultation des membres - août 2021 – API Exports, ajout de champs
API / Exports
– De nouvelles natures de liens entre les offres ont fait leur apparition.
– Ajout des activités liées à un prestataire d’activités.
Mise à jour des schémas JSON correspondants. - juin 2021 – API Écriture et source des images
API Écriture
– Ajout d’une méthode pour tester les droits et les possibilités d’écriture sur une fiche avant l’écriture réelle.
Autorisation d’écriture sur un objet– Ajout de la source d’un multimédia afin de pouvoir tracer la passerelle ou l’outil d’origine.
Spécificité des multimédias en écritureAPI Lecture et Exports
– Exposition de la source des multimédias si une source est spécifiée. - mars 2021 – API Export ajout de champs
API Membre
– Ajout du nombre de contrats de traduction
– Correction du nombre de projets renvoyé en prenant en compte les abonnements aux projets multi-membres et les projets tests non désactivés.
Détail des informations sur les API MembresAPI / Exports
– Ajout des titres (libelleFr) des descriptifs privés
– Ajout de l’ordre des descriptifs privés
Mise à jour des schémas JSON correspondants. - février 2019 – API Membres et API utilisateurs
Ajout des API Membres
– Ajout v002/membre/get-by-id/
– Ajout v002/membre/get-membres/
Ajout des API Utilisateurs
– Ajout v002/utilisateur/get-by-id/
– Ajout v002/utilisateur/get-by-mail/
– Ajout v002/utilisateur/get-by-membre/
– Ajout v002/utilisateur/get-all-utilisateurs/
Ces API son limitées à des droits particuliers étudiés au cas par cas en fonction des besoins. - juin 2018 Multi-horaire
API Multi-Horaire
Mise en place des nouvelles API urbanisées permettant d’interroger le multi-horaire en lecture. - mars 2018 – Ajout date de MAJ et source d’export
Amélioration de la gestion du différentiel
– Un champ gestion.dateExportModification a été ajouté sur tous les objets touristiques. Ce champ fournit la date de dernière modification d’un objet touristique, vous permettant une meilleure gestion du différentiel
Pour plus d’informations, rendez-vous iciExports : ajout de la source d’export
– Une option a été ajoutée dans la configuration technique des projets de diffusion afin que, dans le flux d’export, soit ajouté un fichier reprenant les informations du projet et membre émetteurs du flux.
Pour plus d’informations, rendez-vous ici - mai 2017 – passage de SITRA à Apidae
Le nom de domaine sitra-tourisme.com est maintenant remplacé par celui-ci : apidae-tourisme.com
- octobre 2016 – Ajout de champs et contrôles d’écriture
En écriture, l’unité d’age est désormais obligatoire sur les ages min et max.
En lecture, ajout de nouveaux champs:- Taxe de séjour incluse
- Disponible sur :
- Hébergement collectif
- Hébergement locatif
- Hôtellerie
- Hôtellerie de plein air
- Nom technique : taxeDeSejourIncluse
- Valeurs possibles
- NON
- OUI
- NON_COMMUNIQUE
- Disponible sur :
- Nb visiteurs/spectateurs attendu
- Disponible sur :
- Fêtes et manifestations
- Nom technique : NbVisiteursAttendu
- Valeurs possibles : Entier
- Disponible sur :
- Nb participants/organisateurs attendu
- Disponible sur :
- Fêtes et manifestations
- Nom technique : NbParticipantsAttendu
- Valeurs possibles : Entier
- Disponible sur :
- Taxe de séjour incluse
- juillet 2016 – ajout de champs
Ajout de nouveaux champs et dépréciation d’anciens champs. Toutes les modifications ont été effectuées en prenant garde d’assurer au maximum la continuité des développements existant.
Les schémas ont aussi été mis à jour. - juin 2016 – critères internes
Les critères internes font maintenant partis des API en écriture.
Pour en savoir plus
> Critères internes
> v002/criteres-internes/ - juin 2016 – objets liés
Quelques nouveautés concernant les objets liés :
- Les territoires (TER) peuvent maintenant porter des objets liés.
- Introduction d’un nouveau type de lien COUPS_DE_COEUR_INCONTOURNABLES
- décembre 2015 – métadonnées tripadvisor
Les données tripadvisor arrivent sur Apidae ; au menu, un premier fournisseur pour la région de Bourg en Bresse, ainsi qu’un guide et des scripts pour vous aider si vous souhaitez à votre tour devenir fournisseur des correspondances Apidae – tripadvisor
- octobre 2015 – objets masqués
Une mise à jour de la configuration de projet permet désormais de mettre à disposition, si vous le désirez, les objets masqués dans les API et exports.
Tous les projets existant sont configurés pour ne pas modifier le comportement existant : les objets masqués ne sont PAS mis à disposition et aucune action n’est nécessaire de votre part.
Si vous activez cette option, vous devez veiller à filtrer vos affichages dans vos développements, les objets masqués n’ayant pas vocation à être communiqués au public.
> Documentation configuration projet Export
> Documentation configuration projet API - septembre 2015 – API en écriture
Les API en écriture ont été livrées en production. Les développeurs désirant les exploiter doivent auparavant se manifester auprès du réseau Sitra de manière à présenter leur projet.
- septembre 2015 – métadonnées
Les API pour les métadonnées sont disponibles en production. Les développeurs désireux de les exploiter sont invités à consulter la documentation correspondante ainsi qu’à présenter leur projet au réseau.
- printemps – été 2015
Ajout de nouveaux champs et dépréciation d’anciens champs. Toutes les modifications ont été effectuées en prenant garde d’assurer au maximum la continuité des développements existant.
- 25 mars 2015
Livraison modifications sur les ouvertures – cf Ouverture – champs ouvertTouteLAnnee, fermeTemporairement, nouveaux jours fériés.
> Explication sur les ouvertures complémentaires - 11 février 2015
Introduction d’un client open-source PHP (scope de fonctionnalités : consultation, SSO, métadonnées, helpers pour les exports)
Mise à disposition du SSO Sitra
> Présentation sitra-api-php
> Documentation SSO OAuth2 - 4 février 2015
Généralisation de la notion de prestataire
> Documentation - 27 août 2014
Livraison des formats v2 (avec support des aspects).
Livraison de l’export des dates d’ouverture.
Livraison du tri par date.
> Documentation sur la migration v1 – v2
> Documentation sur l’export des dates d’ouverture - 10 avril 2014
Livraison de nouveautés liées aux nouvelles possibilité de saisie :
Documentation sur la notion de prestataire
Documentation sur les liens typés entre objets touristiques
Documentation sur les identifiants contacts / moyens de communication - 28 février 2014
Correction tri RANDOM : non respect du randomSeed.
Suite à la migration du 5 février 2014, plusieurs requêtes identiques successives exploitant le même randomSeed pouvaient retourner des résultats ordonnés de manière complètement différente.
Une livraison ce jour à 13h corrige le problème et rétablit le comportement précédent.
- 28 novembre 2013
Mise en place de l’offre Open Data
- 17 octobre 2013
Correction des exports XML. De manière non cohérente avec la sortie json, le champ contenant les mails à contacter pour signaler un problème sur un objet était nommé signalerUnProblemeMail au lieu de signalerUnProblemeMails.
La mise à jour fournit les deux champs avec des valeurs identiques. Le champ erroné signalerUnProblemeMail sera prochainement supprimé.
- 11 avril 2013
Suite à une erreur d’import, la durée des activités (type activité) et des itinéraires (type équipement) pouvait être différente d’une minute par rapport aux données saisies dans Sitra 1.
Le cas était en particulier rencontré pour 2h30, … qui était remonté comme 149 minutes au lieu de 150.
Une mise à jour le 11 avril 2013 au soir corrige le problème d’import et corrige toutes les données existantes.
- 3 avril 2013
Livraison des API de consultation du référentiel (communes, éléments de référence, critères internes et sélections) – cf documentation. Les modifications apportent des nouveaux services. Les services existant ne sont pas affectés.
Livraison officielle des exports.
- 21 février 2013
Livraison des évolutions suivantes :
- ajout du tri aléatoire
- ajout du requêtage par membre propriétaire
- ajout des champs relatifs aux images handicap et hiver, ajout des nouveaux types de multimédia liés aux webcams, applications mobiles et tablettes, …
Les schémas JSON ont été mis à jour.
La documentation a été mise à jour.
- 17 décembre 2012
Correction d’un bug sur les tarifs.
Dans le cas où on avait plusieurs traductions dans le champ descriptionTarif.periodes[].tarifs[].precisionTarif (par exemple libelleFr et libelleEn), alors on avait de manière erronée le même tarif plusieurs fois (une fois par langue) dans le tableau descriptionTarif.periodes[].tarifs[]
Tous les objets affectés ont été corrigés le 17 décembre 2012 à 21h. La source du problème a été éliminée.
Par ailleurs, nous avons mis en place un fichier crossdomain.xml permissif sur www.sitra-tourisme.com et sitra-vm-preprod.accelance.net.
- 12 décembre 2012
Partage des sélections entre tous les sites webs d’un même membre