Changelog

Liste des dernières modifications / évolutions techniques de la plateforme Apidae

  • 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
    – dateLimiteDePublication

    Par 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=PAYANT

    Par ailleurs, le champ descriptionTarif.tarifsEnClair n’é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 format YYYY-MM-DD seront 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 noeud informations de 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.schema

    Consulter la documentation sur les dates et actions d’expiration

    Consulter la documentation sur les API d’écriture

  • 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 écriture

    API 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 Membres

    API / 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 ici

    Exports : 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
    • Nb visiteurs/spectateurs attendu
      • Disponible sur :
        • Fêtes et manifestations
      • Nom technique : NbVisiteursAttendu
      • Valeurs possibles : Entier
    • Nb participants/organisateurs attendu
      • Disponible sur :
        • Fêtes et manifestations
      • Nom technique : NbParticipantsAttendu
      • Valeurs possibles : Entier
  • 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.

    > Nouveaux champs ; modifications (été 2016)
    > Schémas

  • 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

    > Liens entre objets touristiques

  • 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

    > Exploiter ou fournir la métadonnée 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.

    > Documentation des API en écriture

  • 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.

    > Documentation des métadonnées

  • 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.

    > Documentation des nouveaux champs

  • 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

    Description technique 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