Aller au contenu

Barrières (Came / FAAC)

L’hôte arrive en voiture, la caméra ou le lecteur RFID reconnaît sa plaque, la barrière s’ouvre. Aucun personnel à l’entrée. CampOne gère la liste blanche : lorsqu’une réservation est confirmée avec une plaque d’immatriculation, celle-ci est inscrite auprès de l’éditeur de la barrière pour les dates de séjour ; au départ, elle est retirée.

L’adaptateur prend en charge Came et FAAC d’origine, et il est structuré de telle sorte qu’un troisième fournisseur puisse être ajouté sans réécrire l’intégration des réservations.

  • Inscription automatique au passage Réservation → CONFIRMED (lorsqu’une plaque est saisie)
  • Désinscription automatique au passage Réservation → COMPLETED
  • Webhook entrant pour les événements de passage / transit de la barrière (signé en HMAC-SHA256)
  • Journal d’audit de chaque inscription / désinscription / événement

Came et FAAC sont tous deux des programmes partenaires / OEM — pas d’inscription en libre-service à leur API. Soumettez une demande de partenariat :

  • Came Connect : https://www.came.com/global/en/contact-us/ — demandez à être orienté vers Came Svizzera
  • FAAC eBoard / J-Track : appelez +39 051 61724 (siège FAAC, Bologne) — pas de programme développeur public ; l’accès à l’intégration passe par l’installateur

Vous aurez besoin :

  • De l’URL de base de l’API du fournisseur (variable selon l’éditeur)
  • Des identifiants API selon le schéma d’authentification du fournisseur (souvent un bloc JSON — Came utilise OAuth, FAAC utilise un X-Api-Key)
  • D’un gate_id / identifiant d’installation
  • Du secret de signature webhook (si la barrière pousse les événements de passage vers CampOne)

Réglages → Intégrations → Adaptateurs fournisseurs → Schranken :

ChampDescription
ProviderCame, FAAC ou Other
EnvironmentTest / Production
EndpointL’URL de base de l’API du fournisseur
Gate IDVotre identifiant d’installation côté fournisseur
Allowlist formatLicense plate ou RFID tag — selon ce que lit votre matériel
API credentialsBloc JSON contenant ce que demande le fournisseur ({"client_id": "…", "client_secret": "…"} pour Came ; {"api_key": "…"} pour FAAC)

Cliquez sur Save, puis sur Test connection. La sonde appelle l’endpoint « passages récents » du fournisseur — une pastille verte confirme.

Le champ plaque apparaît sur le formulaire de création de réservation (à côté de la nationalité). Les opérateurs peuvent aussi le laisser vide — les hooks Schranken sont silencieux en l’absence de plaque, le reste du flux de réservation n’est donc pas affecté.

Si l’éditeur prend en charge les webhooks sortants, configurez l’URL webhook de CampOne de leur côté. L’endpoint est accessible publiquement mais sa signature est vérifiée — sans en-tête HMAC valide, les requêtes sont rejetées. Les événements de passage sont enregistrés dans le journal d’intégration pour pouvoir auditer qui est entré, et quand.

L’adaptateur dispose d’une abstraction interne BarrierProvider. Ajouter un troisième fournisseur (par ex. Nice) est une modification d’un seul fichier dans services/providers.py — parlez-en à votre partenaire d’intégration si vous avez une autre barrière sur site.

FournisseurContact
Camehttps://www.came.com/global/en/contact-us/
FAAC+39 051 61724 (siège Bologne) · https://www.faac.biz/contacts
  • La documentation de Came Connect et FAAC eBoard est partiellement fermée ; les deux adaptateurs utilisent des chemins REST best-effort qui pourront nécessiter un ajustement quand l’éditeur confirmera les endpoints exacts. La couture est volontairement étroite, pour qu’un correctif d’une ligne suffise.
  • La plaque est saisie au moment de la création de la réservation. Si un hôte change de voiture à l’arrivée, vous devez mettre la plaque à jour sur la réservation, ce qui désinscrira l’ancienne et inscrira la nouvelle.