Apidae pour les développeurs

Recouper l’identifiant d’une autre base ou une donnée externe avec Apidae ? Facile.

Vous pouvez stocker des références extérieures dans Apidae directement via les API. Sur n’importe quelle fiche, sans avoir besoin de respecter le workflow habituel.

Et vous pouvez conserver cette donnée pour votre usage personnel ou la proposer à l’ensemble du réseau. Comme bon vous semble.

Chaque membre du réseau peut créer un projet test. Ce type de projet est un “bac à sable”, copie conforme d’un projet numérique habituel. Il permet de se familiariser avec les sélections, les filtres, le format des données et le fonctionnement des projets numériques.

Il vous permet aussi d’attaquer les développements en conditions réelles. Vous choisissez vous-même les offres que vous souhaitez utiliser dans votre projet et vous les organisez comme bon vous semble. Avec un millier d’offres disponibles, vous êtes enfin parés pour développer cette idée qui vous tient à coeur… et vous pourrez la présenter à votre client avec les données de son territoire !

La plateforme de pré-production est ouverte pour les développeurs afin de tester les développements présentant un risque de perturbation en cas d’erreur : API en écriture, métadonnées, tests sur de gros volumes de données… Elle permet de développer et de tester des développements à risque tout en gardant l’esprit serein.

C’est que cette plateforme que les équipes Apidae testent les évolutions à venir.

En savoir plus

Apidae fonctionne avec un grand nombre d’items : communes, territoires, critères internes ou éléments de référence plus classiques tels que la piscine ou le wifi. Tous ces éléments sont indexés dans les référentiels.

Ces référentiels sont recherchables et exportables au format MS. Excel directement à partir de l’interface de la plateforme pour plus de facilité. Chefs de projets, clients et développeurs ont accès aux mêmes référentiels et parlent le même langage pour fluidifier les échanges.

Quand on construit, développe, recette, on a besoin d’exemples. On a besoin de voir une même offre via l’interface (côté contributeur), via les API ou les exports (côté développeur), c’est ce que permettent les outils de sérialisation.

Ils affichent une offre touristique sous ses différents formats possibles (JSON, XML) dans ses différentes version de format, quelle que soit la langue choisie, etc…

Il est même possible de tester la juste profondeur de champs nécessaire pour s’assurer que les données souhaitées sont bien présentes, sans que le flux soit encombré par des données inutiles.

Une même offre, visualisable sous tous ses angles possibles en fonction de vos besoins.

De plus en plus de développements faits par Apidae ou par les membres du réseau sont reversés en open source.

Ces développements sont disponibles sur le GitHub Apidae et notamment :

• Apidae PHP Api Client, un connecteur PHP maintenu à jour par la communauté pour gagner du temps et ne pas ré-inventer la roue à chaque développement.
• un plugin WordPress à destination des développeurs pour faciliter l’exploitation des données Apidae
• les sources de l’application mobile ApiApp,
• les sources du projet d’interface de saisie simplifiée pour les journées du patrimoine avec son workflow de validation intégré,
• des scripts pour faciliter la mise en place de la correspondance entre les offres Apidae et tripadvisor

A votre arrivée sur Apidae, vous venez avec une idée, un besoin, mais vous ne connaissez pas la plateforme et toutes les possibilités qu’elle peut vous offrir.

Pour éviter le “si j’avais su ça avant !”, Apidae vous accueille avec une visite guidée des outils et méthodes qui vous seront utiles pour développer plus efficacement vos projets.

Une visite guidée n’est pas figée, elle s’adapte à votre besoin du moment. Expliquez nous ce que vous souhaitez faire et nous adapterons la visite à ce qui vous sera réellement utile. De notre côté, Apidae est notre outil de travail quotidien, nous saurons vous conseiller sur les meilleures solutions pour répondre à votre besoin.

Durée : 1h à 1h30 sur rdv.
Demande de visite guidée auprès de Serge Bregliano

Le site d’aide spécifique dédié aux développeurs vous accompagne pour faire les bons choix techniques en amont, vous exposer les différences entre les API et les exports, les bonnes pratiques d’optimisation de votre code, etc…

Ce site contient surtout toute la bible technique des différentes API, comment construire vos query, appeler les sélections, gérer les tris, etc… des besoins les plus simples aux plus techniques. Et parce qu’une bonne ligne de code vaut mieux que de longs discours, la documentation est agrémentée de nombreux exemples dans différents langages.

Malgré le site d’aide dédié aux développeurs, il arrive parfois qu’un développeur se retrouve bloqué devant un bout de code rétif.

Qui de mieux placé pour vous répondre que les développeurs de la plateforme Apidae ? Derrière l’adresse hotline.dev@apidae-tourisme.com se cache une équipe qui saura vous aider à résoudre les éventuels problème que vous rencontrez.

Afin que nous puissions vous apporter une réponse la plus efficace possible, n’hésitez pas à nous communiquer toutes les informations utiles à la compréhension de votre problème :

• L’identifiant de votre projet
• L’environnement sur lequel se produit l’incident
• Le détail de l’erreur (code retour, stack, …)
• API : vos paramètres d’appel
• En fonction du contexte : l’identifiant de l’objet, du filtre, de la sélection
• Éventuellement : extrait de votre code source posant problème

Parallèlement au site d’aide pour les aspects technique de la diffusion de l’information, un parcours spécifique est disponible sur le site d’aide utilisateur. Il regroupe tous les tutoriels dont vous avez besoin pour travailler efficacement avec vos clients.

De la création d’un projet test jusqu’à devenir fournisseur de métadonnées, chaque fonction est détaillée dans un tutoriel spécifique agrémenté de copies d’écran pour vous aider à réaliser vos tâches le plus rapidement possible.

Parce que dans un réseau nous avons besoin de faire circuler de l’information, et dans certains cas, particulièrement rapidement.

Restez informés en temps réel en vous inscrivant sur nos Google Groups :

• évolutions de la plateforme, informations importantes, appels à projets… sur Apidae-Dev-Announce
• planifications de maintenance, perturbations sur les plateforme, etc… sur Apidae-Dev-Status

Demande d’abonnement à ces groupes auprès de Serge Bregliano