Agences : ce que coûte un connecteur Apidae maison

Votre client, un office de tourisme ou une collectivité, veut ses fiches Apidae sur son nouveau site. L’API est documentée, votre équipe sait écrire une extension WordPress : développer l’import vous-même est tentant. Voici ce que ce connecteur devra faire en production, et ce qu’il vous coûtera ensuite.

La démo, c’est la partie facile

Interroger une sélection, lire le JSON et créer des articles WordPress, c’est la partie qui se montre en réunion, et la plus courte. Nous éditons WP-Apidae et l’avons fait évoluer d’une version majeure à l’autre : l’essentiel du travail se trouve dans ce que le connecteur doit faire sans témoin, sur de grosses sélections, pendant des années.

Ce qu’un connecteur doit couvrir

Appels, pagination et file d’attente

Une grosse sélection ne s’importe pas dans une seule requête PHP : le délai d’exécution du serveur tombe avant la fin. Il faut paginer les appels, découper le travail en tâches et le confier à une file d’attente. WP-Apidae utilise Action Scheduler, la file de WooCommerce, et importe en arrière-plan.

La file apporte son propre piège. Une tâche qui, en se terminant, programme la suivante ne programme rien si elle est tuée en cours de route, par un délai dépassé ou une erreur fatale. Nous l’avons payé sur l’un de nos propres sites : 31 sélections sur 32 ne se synchronisaient plus depuis onze mois, sans aucune alerte. La version 6.3.8 a ajouté un surveillant qui reprogramme l’import après un échec, et un signal de retard dans l’écran des sélections.

Mise à jour et suppression des fiches

Retirer d’un site une fiche sortie de la sélection, c’est attendu. La retirer parce que l’API n’a pas répondu, c’est une perte de données. Le même article raconte comment une panne de l’API, lue comme « aucune sélection disponible », faisait supprimer des sélections entières avec leurs fiches. Un connecteur doit distinguer une liste vide d’une erreur dès sa première version.

Il faut aussi décider du rythme. WP-Apidae met à jour toutes les 2 h par défaut, réglable jusqu’à 24 h. Le temps réel par webhook existe en option : il est désactivé par défaut et doit être déclaré dans Apidae. Un point d’entrée ouvert sur le site, cela veut dire une authentification et un contrôle de ce qu’on reçoit.

Médias

Pour avoir des pages rapides, on n’affiche pas les photos directement depuis les serveurs d’Apidae. Il faut les copier dans la médiathèque, générer les tailles utiles, prévoir une image par défaut, puis supprimer l’ancienne quand l’office la remplace. WP-Apidae copie aussi les documents et les tracés du bloc Multimédia. Sans ce ménage, la médiathèque gonfle à chaque synchronisation.

Langues, ouvertures et aspects

WP-Apidae importe six langues (français, anglais, allemand, espagnol, italien, néerlandais). Sur un site multilingue, chaque traduction doit rester liée à sa fiche d’origine, et les classements, labels ou équipements doivent s’afficher dans la langue de la page.

Les périodes d’ouverture et les dates d’événements demandent leur propre logique : un événement à plusieurs dates, une fiche fermée une partie de l’année, un agenda qui ne doit pas montrer ce qui est passé.

Les aspects sont plus subtils. Une fiche peut porter une déclinaison hiver, été, groupes ou accessibilité. Selon la documentation d’Apidae, un aspect ne fait que surcharger certains champs de la fiche. Et un champ déclaré dans l’aspect sans valeur veut dire que la valeur standard doit disparaître. Un connecteur qui fusionne naïvement affiche des informations que l’office a voulu retirer.

Taxonomies, recherche à facettes et cartes

WP-Apidae gère quatorze types d’objets Apidae, rangés dans une cinquantaine de taxonomies : communes, thèmes, labels, distinctions. Filtrer une liste de fiches par commune, par date et par capacité avec des requêtes sur les métadonnées de WordPress ne tient pas sur de gros volumes. WP-Apidae écrit pour cela une table d’index dédiée, mise à jour à chaque import, avec des facettes pour les taxonomies, les dates, les coordonnées, le titre et la capacité. La carte s’appuie sur les mêmes données, avec le choix de ses fonds.

Modèles d’affichage et données structurées

Chaque type de fiche a besoin d’une page et d’une carte dans les listes, que l’équipe du client doit pouvoir faire évoluer sans vous rappeler. WP-Apidae installe 28 modèles par défaut, une fiche et une carte par type, modifiables dans l’éditeur de blocs, ou dans Elementor et Divi avec leurs modules. Reste le balisage schema.org : pour un événement à plusieurs dates, WP-Apidae en déclare un par date à venir.

Ce qui coûte après la mise en ligne

L’API évolue sans vous attendre

En juin 2025, Apidae a supprimé l’API externe qui servait les horaires et les a réintégrés dans les fiches. Sans correctif, l’import des fiches à périodes d’ouverture échouait en erreur fatale. Plus largement, Apidae regroupe depuis 2024 les classements, labels, chaînes et guides dans un tableau unique, les distinctions, et annonce la suppression des anciens champs à partir de l’été 2027. Avec un connecteur maison, chacun de ces changements devient un chantier à planifier site par site, et il faut à chaque fois savoir qui le paie.

Performance et environnement

Un import tourne sur l’hébergement du client, à côté de son cache et de ses autres extensions. Il faut un cache des requêtes de liste, rester compatible avec le report du JavaScript que pratiquent les extensions de cache, et suivre les montées de version de PHP et de WordPress. WP-Apidae demande aujourd’hui PHP 8.2 et WordPress 6.1 au minimum.

Le support quand le client appelle

« Ma fiche n’est pas à jour sur le site. » Derrière cette phrase, la cause peut être une saisie dans Apidae, une sélection mal construite, un import en échec, un cache de page ou un réglage d’hébergement. Pour trancher vite, il faut des journaux et un état lisible de chaque sélection. Il faut surtout quelqu’un qui connaît encore le code des années après son écriture.

La charge, poste par poste

Sans chiffrer à votre place, voici les postes de travail qu’un devis honnête doit couvrir :

• le développement de chacun des points décrits plus haut ;
• la recette sur données réelles : grosses sélections, fiches multilingues, aspects, événements à dates multiples ;
• la veille sur la documentation d’Apidae et l’adaptation à ses changements ;
• la maintenance corrective et les montées de version de PHP et de WordPress ;
• le support de premier et de second niveau auprès du client ;
• la documentation interne, pour que le connecteur survive au départ de son auteur.

S’y ajoutent les risques vus plus haut, qu’il faut accepter : une panne silencieuse découverte des mois plus tard, une suppression de fiches sur une erreur d’API, un correctif urgent quand Apidae change un format, un savoir concentré sur une seule personne. Chaque site équipé d’une variante du connecteur multiplie ces postes.

En face, la licence

Une licence WP-Apidae vaut pour un site et pour un an : 99 € HT pour le cœur, 49 € HT par module. Elle se renouvelle chaque année jusqu’à annulation et donne accès aux mises à jour et au support par ticket. Seul le site de production compte : une copie de recette ou de développement ne consomme pas de licence.

Il n’existe pas de tarif agence. L’agence achète la licence à son nom et la refacture à son client. La licence appartient à l’adresse e-mail qui l’a achetée, et c’est depuis ce compte que se gèrent activations et renouvellement. Une licence peut être remboursée dans les 14 jours si l’extension ne convient pas.

Le sur-mesure ne disparaît pas pour autant. Les hooks d’import, d’indexation et de listing, et le hook apidae_loaded pour un module ou un thème, sont décrits dans la documentation technique. Votre valeur ajoutée reste le thème, l’expérience de visite et les besoins propres au client.

Quand le connecteur maison se justifie

Développer reste le bon choix dans certains cas :

• le projet n’est pas un site WordPress : application mobile, site sur un autre CMS, front découplé qui n’interroge pas WordPress ;
• Apidae n’est qu’une source parmi d’autres, fusionnées dans un entrepôt de données qui alimente plusieurs supports ;
• votre agence équipe de nombreux sites Apidae avec un connecteur commun, et une équipe y est affectée dans la durée, avec la veille et le support que cela suppose.

Dans les autres cas, comparez le devis du connecteur et de sa maintenance pluriannuelle à une licence par site de production. Notre page pour les agences web détaille l’intégration avec vos outils, les licences et le support.