Documentation technique

Accueil / Documentation technique / Flux v2 / API de consultation (JSON) / Liste des services / v002/objet-touristique/get-by-identifier/

v002/objet-touristique/get-by-identifier/

Récupérez un objet touristique à partir de son identifier.

L’identifier est un héritage historique de la plate-forme Apidae. Les identifiers sont des chaines de caractère au format alphanumérique (pour les nouveaux objets, SITRA__).
Pour les anciens objets, les identifiers historiques ont été maintenus.
Nous vous recommandons d’utiliser les identifiants si cela vous est possible.

/v002/objet-touristique/get-by-identifier/{identifier}?&apiKey={apiKey}&projetId={projetId}

Description
Méthode GET

{identifier} est l’identifier numérique de l’objet à récupérer
callback (optionel) : nom de la fonction de callback (pour JSONP)
responseFields (optionnel) : cf Filtrage des données
locales (optionnel) : cf Filtrage des langues
apiKey : clé d’API
projetId : identifiant du projet

Aperçu
avec tous les paramètres

/v002/objet-touristique/get-by-identifier/{identifier}?callback={callback}&responseFields={responseFields}&locales={locales}&apiKey={apiKey}&projetId={projetId}

Exemple

/v002/objet-touristique/get-by-identifier/SITRA_EVE_123467?responseFields=id,nom&locales=fr,en&apiKey=XXXX&projetId=12345

Format de sortie

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.

Exemple de réponse

{
  "type" : "ACTIVITE",
  "id" : 6582,
  "nom" : {
    "libelleFr" : "Ski de randonnée"
  },
  "presentation" : {
    "descriptifCourt" : {
      "libelleFr" : "Ski de randonnée : Initiation : Chalune, Bostan, Les Aravis, le Passon, le Tour Noir, Ovronnaz et ensuite les bains thermaux avant de rentrer... Tarif : 60 € par personne + remontées mécaniques si besoin."
    }
  }
}