Appels enrichis

Il est possible de récupérer un objet touristique enrichi des informations fournies par des partenaires d’Apidae

Ces enrichissements se basent sur des données préalablement liées en métadonnée pour lesquelles Apidae va ensuite collecter la donnée finale afin d’être en mesure de la livrer en un seul appel.

Les enrichissements ne sont disponibles qu’en API, ils sont livrés dans des nœuds identifiés en fin de flux JSON.

Appels disponibles en pré-version !

Attention, cette fonctionnalité est actuellement fournie en version Beta
Les fonctionnalités et le endpoint sont appelés à évoluer

Attention

https://api.plateforme.apidae-tourisme.com/apidae/objetenrich/?id={id}&apiKey={apiKey}&projetId={projetId}&enrichments={multihoraire}

Description
Méthode GET

{id} est l’identifiant numérique de l’objet à récupérer
callback (optionnel) : nom de la fonction de callback (pour JSONP)
responseFields (optionnel) : cf. Filtrage des données
locales : cf. Filtrage des langues
apiKey : clé d’API
projetId : identifiant du projet
enrichments : liste des enrichissements souhaités, séparés par une virgule

Aperçu
avec tous les paramètres

https://api.plateforme.apidae-tourisme.com/apidae/objetenrich/?id={id}&callback={callback}&responseFields={responseFields}&locales={locales}&apiKey={apiKey}&projetId={projetId}&enrichments={enrichissements}

Exemples

API Consultation

https://api.plateforme.apidae-tourisme.com/apidae/objetenrich/?id=5340901&apiKey=XXXXX&projetId=12345&responseFields=id,nom&locales=fr,en&enrichments=multihoraire

Service de consentement

https://api.plateforme.apidae-tourisme.com/apidae/objetenrich/?id=5340901&?apiKey=f399cf0b-c557-6609-be75-1337d388a404&projetId=9fd02c13-42e7-534f-955g-4333d3071c80&responseFields=id,nom&locales=fr,en&enrichments=multihoraire

Format de sortie

> Documentation format des objets touristiques (format JSON)

Les données enrichies sont livrées à la suite des données touristiques. Ces données sont au format dans lequel le fourni leur propriétaire.

Enrichissements – enrichments

multihoraire : fournit les données liées aux périodes du multi-horaire. Consulter le format du multi-horaire pour plus de détails.
avizi-dispo : fournit les données de disponibilités proposées par la solution Avizi de Proximit.
Consulter le format des disponibilités pour plus de détails.
apidae-photo : fournit les données de qualité d’Apidae-Photo. Détail du format sur la description de l’API Apidae-Photo.
regiondo-paca : fournit les données Regiondo pour les offres touristiques de la Région Sud. Détails du format.

Cas d’erreur

Erreur 404 : objet non trouvé ; le corps de la réponse HTTP contient le message d’erreur au format texte.
Erreur 50x : erreur de traitement ; le corps de la réponse HTTP contient le message d’erreur au format texte.
Unalowed enrichments : Erreur dans le nom d’un partenaire. Le partenaire n’est pas reconnu.

Exemple de réponse multihoraire

{
    "type": "ACTIVITE",
    "id": 5340901,
    "nom": {
        "libelleFr": "ANNULE - Atelier créations végétales / terrarium"
    },
    "ouverture": {
        "periodesOuvertures": [
            {
                "identifiantTechnique": 20376522
            },
            {
                "identifiantTechnique": 20376523
            }
        ]
    },
    "multihoraire": [
        {
            "startDate": "2020-09-12",
            "endDate": "2020-09-12",
            "timePeriods": [
                {
                    "timeFrames": [
                        {
                            "recurrence": null,
                            "endTime": "12:30",
                            "startTime": "10:30"
                        }
                    ],
                    "labels": {
                        "ru": "часы открытия",
                        "fr": "Ouverture",
                        "en": "Opening hours",
                        "nl": "Openingstijden",
                        "de": "Öffnungszeiten",
                        "it": "Orari di apertura",
                        "pt-br": "Horário de abertura",
                        "zh": "开放时间",
                        "ja": "開館時間",
                        "es": "Horarios de apertura"
                    },
                    "type": "opening",
                    "weekdays": [
                        "SAT"
                    ]
                }
            ],
            "externalType": "ACTIVITE",
            "externalRef": 5340901,
            "externalId": 20376522,
            "updatedAt": 1611245091733,
            "type": "apidae_period"
        }
    ],
    "timestamp": 1632385421469
}

Exemple de réponse avizi-dispo

{
    type: "HEBERGEMENT_LOCATIF",
    id: 5698539,
    nom: {
        libelleFr: "A FAIRE A CHEVAL"
    },
    metadonnees: [{
            noeudId: "avizi-dispo",
            contenus: [{
                cible: "general",
                metadonnee: {
                    id: 5698539,
                    entity: 736
                }
            }]
        }
    ],
    avizi - dispo: [{
        id: 5698539,
        name: "A FAIRE A CHEVAL",
        entity: {
            id: 736,
            name: "Office de Tourisme Charente Limousine"
        },
        last_update: "2021-11-16 01:08",
        availabilities: [{
                date: "2021-12-30",
                status: {
                    id: 1,
                    name: "Libre"
                },
                quantity: 0
            },
            {
                date: "2021-12-31",
                status: {
                    id: 1,
                    name: "Libre"
                },
                quantity: 0
            },
            {
                date: "2022-01-01",
                status: {
                    id: 2,
                    name: "Fermé"
                },
                quantity: 0
            },
            {
                date: "2022-01-02",
                status: {
                    id: 2,
                    name: "Fermé"
                },
                quantity: 0
            },
            {
                date: "2022-01-03",
                status: {
                    id: 2,
                    name: "Fermé"
                },
                quantity: 0
            }
        ]
    }],
    timestamp: 1637328477214
}

Exemple de réponse apidae-photos

{
    "apidaePhotoId": 69310,
    "illustrationId": 10822254,
    "note": 3.5,
    "noteMembre": {}
},
{
    "apidaePhotoId": 69309,
    "illustrationId": 10822248,
    "note": 3,
    "noteMembre": {}
},
{
    "apidaePhotoId": 69308,
    "illustrationId": 10822245,
    "note": 3,
    "noteMembre": {}
},
{
    "apidaePhotoId": 69307,
    "illustrationId": 10822243,
    "note": 3,
    "noteMembre": {}
},
{
    "apidaePhotoId": 69306,
    "illustrationId": 10822234,
    "note": 3,
    "noteMembre": {}
},
{
    "apidaePhotoId": 69305,
    "illustrationId": 10822228,
    "note": 3.5,
    "noteMembre": {}
}

Exemple de réponse regiondo-paca

{
    "product_id": "181115",
    "name": "Sunset apero stand up paddle à Marseille",
    "sku": "T-GL54-194878",
    "short_description": "<p>Envie de profiter d'un bon bol d'air frais en fin de journée ? L' apéro-paddle est fait pour vous.</p>\n<p>Une balade sur une eau translucide, une mer d’huile. C'est un moment unique que nous partageons avec vous dans un cadre magnifique avec un beau coucher de soleil sur les îles du frioul :)</p>",
    "geo_lat": "43.245",
    "geo_lon": "5.36916",
    "distance": null,
    "location_address": "Glisse pour tous, Port de la Pointe Rouge, Marseille, France",
    "city": null,
    "zipcode": null,
    "city_id": "485",
    "region_id": "40979",
    "poi_ids": null,
    "country_id": "51",
    "continent_id": "6",
    "thumbnail": "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-60535278344fe490979880-cropped600-400.jpg",
    "appointment_types": "automatically",
    "image": "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-60535278344fe490979880-cropped600-400.jpg",
    "image_label": null,
    "url_key": "sunset-apero-stand-up-paddle",
    "url_path": "sunset-apero-stand-up-paddle",
    "provider": "Glisse Pour Tous",
    "rating_summary": "0",
    "reviews_count": "0",
    "is_appointment_needed": "1",
    "ticket_suitable_for": null,
    "top_things_to_do": ",182",
    "ticket_weather": null,
    "ticket_languages": "145,148",
    "product_supplier_id": "36870",
    "original_price": "40.00",
    "type_id": "ticket",
    "as_gift": "0",
    "covid_19": "1",
    "in_stock": "1",
    "is_expired": "0",
    "created_at": "2021-06-09 07:08:51",
    "updated_at": "2022-06-27 12:54:00",
    "small_image": "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-60535278344fe490979880-cropped600-400.jpg",
    "small_image_label": null,
    "description": "<p>Une bonne balade en stand up paddle sur une eau translucide, une mer d’huile, un coucher de soleil magnifique… <strong>Décompression garantie en se réappropriant le littoral déserté par les hordes de la journée.</strong></p>\n<p>Le principe est de se retrouver pour une balade puis d’un apéro/coucher de soleil sur l’eau, souvent suivi d’un picnic convivial.</p>\n<p>On va longer la côte marseillaise avec un passage devant les jolies plages de l'abri côtier,la Verrerie, le petit port de la madrague , et admirer le coucher de soleil sur les îles du Frioul : toujours aussi beau, et tous les soirs différents !!!</p>\n<p>Sortie ouverte à tous les niveaux (débutants, experts, nouveaux etc...), avec encadrement par un moniteur brevet d'état, qui vous donnera toutes les clés pour une maîtrise parfaite de l'engin, la séance se déroulera par une initiation, une balade rythmée de pause (sur le patrimoine, sur des jeux ludiques) ces balades sont accessibles à tout public, l'accent est mis sur la convivialité.</p>\n<p> <em>Si météo mauvaise, ne vous inquiétez pas, on a la solution pour profiter et nous ferons des challenges/défis / jeux, ce sera un moment très fun suivie d'un moment détente pour bien finir la journée :)</em></p>\n<p><em>* Pour les aperos paddle : nous offrons un verre, chips... et nous rentrons au crépuscule.Chacun est libre d'amener un PETIT complément et son eco-cup.</em></p>",
    "category_ids": {
        "2": {
            "name": "default-category",
            "level": "1"
        },
        "3255": {
            "name": "Categories",
            "level": "2"
        },
        "4927": {
            "name": "Sport",
            "level": "3"
        },
        "5805": {
            "name": "Sports nautiques",
            "level": "4"
        },
        "5814": {
            "name": "Standing paddle",
            "level": "5"
        }
    },
    "language_ids": "145,148",
    "meta_title": "Office de Tourisme et des Congrès Marseille - web | Sunset apero stand up paddle à Marseille",
    "meta_keyword": null,
    "meta_description": "<p>Envie de profiter d'un bon bol d'air frais en fin de journée ? L' apéro-paddle est fait pour vous.</p>\n<p>Une balade sur une eau translucide, une mer d’huile. C'est un moment unique que nous partageons avec vous dans un cadre magnifique avec un beau coucher de soleil sur les îles du frioul :)</p>",
    "faq_included": "<p>Pret du materiel pour la pratique du Stand up paddle</p>",
    "faq_not_included": null,
    "faq_participants": "Le départ est assuré à partir de 5 personnes jusqu'à 12 personnes",
    "faq_customer_requirements": "<p>- Bouteille d'eau</p>\n<p>- Tong</p>\n<p>- En-cas</p>",
    "faq_other_info": "<p>L'activité peut être reportée/annulée en cas de mauvaises conditions météo.</p>\n<p>-Prévoir bouteille d'eau/gourde, tong, petit En-cas</p>",
    "faq_spectators": null,
    "important_info": "<p>Chaque personne est garante de son niveau en natation et s'engage à respecter les consignes de sécurité comme l'environnement.</p>",
    "ticket_highlights": "Activité à faire seul, en famille, entre amis....\nA partir de 14 ans\nAccessible à tous les niveaux\nDecouverte de notre patrimoine",
    "ticket_opening_times": [],
    "timezone": "Europe/Paris",
    "info_pdf": [],
    "location_name": "Glisse pour tous base nautique de la pointe rouge",
    "location_specific_info": "Pied dans le sable, face à la mer, nous sommes à gauche, en face de l'asptt, ce sont les locaux en bois ",
    "parking_options_comment": "Parking de la pointe rouge",
    "public_transport_comment": "Metro ligne 2, arret rond point du prado, ligne de bus 19 , arrêt pointe rouge",
    "base_price": "35.00",
    "booking_notice_period": 0,
    "commission_rate": 0.08,
    "duration_type": "hour",
    "duration_values": "3",
    "opening_hours": "",
    "category_titles": "Sport, Sports nautiques, Standing paddle",
    "language_titles": "Anglais, Français",
    "info_pdf_with_names": [],
    "variations": [
        {
            "variation_id": "428355",
            "name": "Billet individuel",
            "from": "2022-07-01",
            "to": "2022-08-31",
            "appointment_type": "automatically",
            "available_dates": {
                "2022-08-26": [
                    [
                        "19:00:00"
                    ]
                ]
            }
        }
    ],
    "video_url": [],
    "image_url": [
        "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-60535278344fe490979880-cropped600-400.jpg",
        "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-60535281900a6745716610-cropped600-400.jpg",
        "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-6053528b3eec7310555215-cropped600-400.jpg"
    ],
    "image_sort_order": [
        {
            "url": "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-60535278344fe490979880-cropped600-400.jpg",
            "thumbnail_url": "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-60535278344fe490979880-thumbnail-360x240.jpg",
            "position": 1,
            "label": ""
        },
        {
            "url": "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-60535281900a6745716610-cropped600-400.jpg",
            "thumbnail_url": "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-60535281900a6745716610-thumbnail-360x240.jpg",
            "position": 2,
            "label": ""
        },
        {
            "url": "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-6053528b3eec7310555215-cropped600-400.jpg",
            "thumbnail_url": "https://cdn.regiondo.net/media/catalog/product/b/i/big-ticket-image-6053528b3eec7310555215-thumbnail-360x240.jpg",
            "position": 3,
            "label": ""
        }
    ],
    "curency_code": "EUR",
    "currency_code": "EUR",
    "operator_information": {
        "name": "Glisse Pour Tous",
        "code": "GL54",
        "address": {
            "zipcode": "13008",
            "city": "Marseille",
            "location_address": "1 port de la pointe rouge"
        },
        "phone": "",
        "url": "https://marseilletourisme.regiondo.fr/",
        "reseller_avg_rating": {
            "avg": 0,
            "count": 0
        },
        "tripadvisor": {
            "rating_image_url": "",
            "reviews_count": "",
            "web_url": ""
        }
    },
    "total_vote_details": [],
    "map_image_url": "https://cdn.regiondo.net/media//catalog/google/maps/17/17b81595575ab6a7ad067fb74902264f.png",
    "tips": null
}