Aller au contenu
INTÉGRATIONS

Connectez les systèmes que vous exploitez déjà

ParkAgenda se connecte aux systèmes que vous exploitez déjà, ANPR, barrières et équipements sur site, via notre API et un connecteur que notre équipe développe avec votre fournisseur. L’installation sur place peut être confiée à un partenaire local proche de votre parking.

  • 93endpoints REST
  • 2connecteurs sur mesure déjà en production
  • 4façons de faire entrer une réservation
CE QUI EST CONNECTÉ AUJOURD’HUI

Quatre façons de faire entrer une réservation dans ParkAgenda

Les quatre produisent la même réservation, attribuée à sa source. Deux d’entre elles sont des connecteurs que notre équipe a écrits pour un fournisseur précis, et c’est le point à retenir.

  • Récupération API, en production

    Parkos

    Les réservations arrivent seules, par marchand, avec le créneau d’arrivée déjà réconcilié.

    Ce que cela veut dire concrètement

    Une récupération directe chez Parkos, par marchand. Les identifiants sont dans Azure Key Vault, les curseurs de synchronisation s’appuient sur les dates de modification et d’annulation avec un recouvrement pour que rien ne passe entre deux exécutions, et les créneaux d’arrivée sont réconciliés à l’entrée. Une réservation qui ne peut pas être rattachée à un marchand est mise en quarantaine plutôt que perdue, et un exploitant peut forcer une récupération à tout moment.

  • Passerelle par interrogation, en production

    Solution Park

    Le deuxième, ajouté de la même façon, sans toucher à la plateforme.

    Ce que cela veut dire concrètement

    Un deuxième connecteur sur mesure, qui interroge la source sur une fenêtre glissante. Il a été ajouté exactement comme le premier, et c’est là l’argument : une nouvelle source, c’est un adaptateur derrière une interface commune, pas une refonte de la plateforme.

  • Adaptateur e-mail

    Le format du revendeur

    Le revendeur continue d’envoyer l’e-mail qu’il envoie déjà.

    Ce que cela veut dire concrètement

    Chaque parking reçoit une adresse surveillée. Une source de réservation déclare le format de ses e-mails et un adaptateur le traduit : le revendeur n’a rien à changer de son côté. Les expéditeurs sont autorisés par adresse exacte, et un doublon est détecté sur l’identifiant du message ou une empreinte du corps.

  • Import

    Migration CSV

    Votre historique de réservations entre sous forme de fichier, et peut être relancé sans risque.

    Ce que cela veut dire concrètement

    L’historique des réservations entre sous forme de fichier. L’import est idempotent sur le parking, la source et la référence : le relancer ne change rien, et chaque ligne revient en créée, mise à jour, inchangée ou en échec avec le motif.

Tout ce qui ne peut pas être appliqué sans risque atterrit dans une file de contrôle, avec la pièce d’origine attachée. Un humain la valide, la retraite, autorise l’expéditeur ou l’écarte. Rien n’est perdu en silence.

L’API

Une vraie API REST, décrite en OpenAPI 3

C’est l’API sur laquelle tourne la console ParkAgenda. Rien n’est réservé à une offre supérieure, et rien dans cette liste n’est une maquette.

Ce que l’API n’est pas

  • Il n’y a pas de programme en libre-service. Pas de clés d’API, pas d’identifiants client, pas de formulaire d’inscription. Un appelant a besoin d’une identité dans notre propre annuaire : nous mettons donc l’accès en place avec vous, plutôt que de vous renvoyer vers une page de jetons.
  • ParkAgenda reçoit des webhooks et n’en envoie aucun. Il n’y a ni abonnement aux événements ni URL de rappel. Les données sortent en lisant l’API ou en prenant un export.

Nous préférons l’écrire ici plutôt que de le dire pendant la démo.

  • 93 endpoints

    Réservations, parkings, organisations, utilisateurs, shifts, trajets de navette, analytics, encaissements, prises en charge de véhicules et enregistrements d’intake, sur des routes de ressources claires.

  • Un document OpenAPI 3

    Intitulé ParkAgenda API, version 1.0.0. Presque chaque opération porte ses paramètres, son corps de requête et ses réponses : un client se génère au lieu de se deviner.

  • Authentification par jeton bearer

    Microsoft Entra External ID émet le JWT. Les rôles sont lus dans le jeton, jamais dans l’appel : une intégration ne peut pas demander plus que l’identité qu’on lui a confiée.

  • Trois webhooks entrants

    Les événements de facturation Stripe avec vérification de signature, les résultats de distribution SendGrid, et SendGrid Inbound Parse pour l’arrivée des réservations, protégé par une clé de fonction.

  • Exports sortants

    Réservations, lignes analytics brutes et récapitulatif de caisse s’exportent par parking, via la même API authentifiée.

ANPR ET ÉQUIPEMENTS SUR SITE

ParkAgenda n’a pas d’ANPR à lui. Il se connecte au vôtre.

Pas de caméras, pas de commande de barrière, pas de lecteur, pas de borne. Ce que ParkAgenda possède, c’est la plaque sur chaque séjour et une API pour la rapprocher. Votre lecture de plaques continue de faire exactement ce qu’elle fait aujourd’hui, et nous construisons le connecteur entre les deux avec le fournisseur qui l’a installée.

Dit simplement

Si vous cherchez un fournisseur qui vous vend les caméras et les barrières, ce n’est pas nous. Si vous les avez déjà, ou si vous les achetez près de chez vous, ParkAgenda est le logiciel derrière, et le travail d’intégration est pour nous.

Comment ça marche en pratique

  1. Votre caméra lit la plaqueLa lecture se fait dans votre système, sur votre matériel, exactement comme aujourd’hui.
  2. La plaque correspond à un séjourChaque réservation dans ParkAgenda porte la plaque du véhicule, normalisée pour la recherche : une lecture retrouve un client, un créneau d’arrivée et une place.
  3. Votre système décide de la suiteOuvrir une barrière, allumer un panneau ou journaliser une entrée reste l’affaire de l’équipement qui le fait déjà. ParkAgenda fournit la réservation, pas la commande.
INSTALLATION

Le travail sur site est réalisé par un partenaire proche de vous

Câblage, fixation, fourniture des caméras et de la barrière, mise en service : c’est le métier de quelqu’un qui peut être chez vous dans l’heure. Nous travaillons avec des installateurs et des intégrateurs locaux proches du parking, et nous prenons la partie logicielle et le connecteur.

Ce que fait ParkAgenda

  • Écrit et maintient le connecteur entre vos équipements et ParkAgenda.
  • Exploite l’API, la correspondance des champs et la réconciliation dès que les réservations circulent.
  • Reste en ligne avec votre fournisseur jusqu’à ce que les deux systèmes s’accordent.

Ce que fait le partenaire local

  • Fournit, installe et câble les caméras, les barrières et les écrans.
  • Configure les équipements sur place et les met en service avec vous.
  • Répond quand un problème matériel exige quelqu’un à l’entrée.

Vous exploitez un parking

Dites-nous quels équipements sont en place aujourd’hui, qui les a fournis et ce que vous attendez d’eux. Nous vous dirons honnêtement si nous pouvons les connecter et ce que cela demande.

Décrivez votre installation

Vous installez des équipements de parking

Si vous installez de la lecture de plaques, des barrières ou du contrôle d’accès près d’un aéroport, nous voulons vous connaître. Nous apportons le logiciel et le connecteur, vous apportez le terrain.

Devenir partenaire
COMMENT ÇA SE CONSTRUIT

Cinq étapes, et le temps que prend chacune

Ces durées viennent des deux connecteurs déjà en production, pas d’une plaquette commerciale. La variable, ce n’est presque jamais notre partie du travail.

  1. Nous listons ce que vous exploitez

    Un appel

    Votre lecture de plaques, votre barrière, vos sources de réservation, l’export que votre comptable réclame. Nous demandons qui a fourni chaque élément et s’il existe une documentation.

  2. Nous fixons le contrat de données

    Quelques jours

    Quels champs circulent, dans quel sens, à quelle fréquence, et que faire quand les deux systèmes divergent. C’est écrit avant que quiconque code.

  3. Nous le construisons sur vos données de test

    Deux à quatre semaines

    Un connecteur de source, c’est un adaptateur derrière une interface commune. C’est ainsi que Parkos et Solution Park ont été ajoutés, et c’est pourquoi le second a pris moins de temps que le premier.

  4. Nous le faisons tourner en parallèle

    Deux semaines

    Votre processus actuel continue pendant que le connecteur écrit dans ParkAgenda. Chaque réservation est réconciliée avant qu’on éteigne quoi que ce soit.

  5. Nous le maintenons en service

    En continu

    Les fournisseurs changent de format sans prévenir. Quand cela arrive, c’est à nous de corriger l’adaptateur, et la file de contrôle fait que les réservations concernées attendent un humain au lieu de disparaître.

La réserve honnête : une source qui arrive par e-mail est en général ce que nous faisons de plus rapide. Un connecteur sur l’API d’un fournisseur dépend de sa documentation et de sa vitesse à répondre à un e-mail. Nous avons connu les deux cas.

QUESTIONS D’INTÉGRATION

Les six questions posées avant chaque contrat, avec les réponses que nous donnons au téléphone.

ParkAgenda inclut-il l’ANPR ?

Non. ParkAgenda n’a ni lecture de plaques, ni caméras, ni commande de barrière. Il se connecte au système ANPR que vous exploitez déjà, via notre API REST, et notre équipe développe ce connecteur avec le fournisseur qui l’a installé.

ParkAgenda peut-il fonctionner avec mon système ANPR de gestion de parking existant ?

Oui, via l’API et un connecteur que nous écrivons pour lui. Chaque réservation dans ParkAgenda porte la plaque du véhicule, indexée pour la recherche : une plaque lue par votre propre système retrouve un séjour, un client et un créneau d’arrivée.

Proposez-vous une API publique à laquelle je peux m’inscrire ?

Non, et nous préférons le dire ici. Il existe une API REST documentée, décrite en OpenAPI 3, mais l’accès exige une identité dans notre propre annuaire : nous le mettons donc en place avec vous. Il n’y a pas de clés d’API en libre-service.

ParkAgenda envoie-t-il des webhooks vers mon système ?

Pas aujourd’hui. ParkAgenda reçoit des webhooks de Stripe et de SendGrid, et n’en envoie aucun. Les données sortent en lisant l’API authentifiée ou en prenant un export, et les deux fonctionnent parking par parking.

Qui installe les caméras et les barrières sur place ?

Un installateur local proche de votre parking. ParkAgenda travaille avec des intégrateurs proches du site pour la fourniture, le câblage, la pose et la mise en service, tandis que nous prenons le logiciel, l’API et le connecteur entre les deux.

Combien de temps prend une intégration sur mesure ?

Une nouvelle source de réservation qui arrive par e-mail est en général en production en deux semaines environ. Un connecteur sur l’API d’un fournisseur demande le plus souvent quatre à huit semaines à partir du premier appel, et le rythme dépend de la vitesse de réponse de ce fournisseur.

Parlez-nous de vos équipements

Dites-nous ce qui est déjà sur votre site

La caméra, la barrière, les plateformes par lesquelles vous vendez, l’export que réclame votre comptable. Nous vous dirons ce qui se connecte aujourd’hui, ce qui demande un connecteur, et ce que nous ne savons pas faire.

  • Mise en service en 24 heures

    Parkings, sources et opérateurs configurés avec vous.
  • Vos données restent les vôtres

    Exportez n’importe quelle vue en CSV ou PDF, quand vous voulez.
  • Support FR et EN

    Par des gens qui ont tenu un comptoir de parking.