Livraison Facile
← Solutions entreprises

Domotique, API & accessibilité

Transformer un code PIN validé en signal utile dans le logement

Lorsqu’un livreur saisit correctement le code PIN de lecture, l’API peut indiquer qu’une nouvelle validation a eu lieu. Une automatisation locale peut alors produire un signal adapté : éclairage coloré, vibration, notification mobile ou carillon.

Le code PIN lui-même n’est jamais transmis par l’API. Une validation indique seulement que la fiche a été déverrouillée ; elle ne constitue pas une preuve de livraison ni une preuve d’identité.

Cas d’usage

Une même information, plusieurs formes d’alerte

Signal visuel accessible

Faire pulser lentement une lampe dans une couleur choisie par l’utilisateur, pendant une durée courte et déterminée.

Vibration personnelle

Envoyer une notification prioritaire sur un téléphone, une montre ou un autre équipement compatible.

Annonce ou carillon

Jouer un son ou une annonce sur une enceinte, en complément de l’alerte visuelle lorsque cela convient au foyer.

Attention aux flashs : privilégiez une pulsation lente et brève. Les flashs rapides, particulièrement rouges, peuvent présenter un risque pour les personnes photosensibles. Le réglage final doit toujours rester sous le contrôle de l’occupant.

Disponible dans l’API

Détecter un changement sans recevoir le secret

Événement minimal

Déclencher uniquement lorsque le compteur progresse

L’intégration mémorise la dernière valeur connue. Une valeur supérieure signifie qu’un livreur vient de valider le code PIN de lecture.

Endpoint authentifié GET /api/v1/consignes/{code}/status Clé API requise
Compteur
pin_validations_count
Nombre monotone de validations réussies.
Dernier événement
last_pin_validated_at
Horodatage de la validation la plus récente.
Vie privée
Aucun secret transmis
Ni code PIN, ni contenu privé, ni adresse IP du lecteur.
Autorisation
Propriétaire uniquement
L’entreprise doit être propriétaire de la consigne.
Fenêtre conseillée10 s pendant 2 h
Consommation720 / 1 000

Il reste 280 appels pour la journée. Interrogez le statut uniquement pendant la plage de livraison annoncée, jamais en continu toute la journée.

Architecture recommandée

Garder la maison privée et la décision en local

1

Code PIN accepté

Livraison Facile enregistre seulement l’événement minimal.

2

Statut API

Le backend partenaire interroge la consigne avec sa clé privée.

3

Règle locale

Le moteur compare le compteur à la dernière valeur connue.

4

Équipement

La passerelle locale commande lampe, montre ou enceinte.

5

Retour à l’état

L’action s’arrête seule et restaure l’éclairage précédent.

Ces noms et logos servent uniquement à identifier des exemples de plateformes ou de briques d’automatisation ; aucune affiliation n’est revendiquée. La compatibilité exacte dépend de l’équipement et du connecteur mis en place.

Actions adaptées

Informer sans créer de danger

  • Éclairage lent et temporaire
  • Notification mobile ou vibration
  • Annonce vocale ou carillon non critique
  • Journal local limité et effaçable

Limites de sécurité

Ne pas piloter les accès sensibles

  • Ne pas déverrouiller automatiquement une porte
  • Ne pas ouvrir un portail ou un garage
  • Ne pas désactiver une alarme
  • Ne pas assimiler la validation à une preuve de livraison

Une évolution vers des webhooks signés pourra être étudiée pour des besoins proches du temps réel. Elle nécessitera une activation explicite, une liste de destinations autorisées, une signature vérifiable, des reprises contrôlées et une protection contre les appels vers les réseaux privés.

Préparer un pilote accessible

Commencez par une alerte non critique

Définissez une courte plage de livraison, testez le changement de compteur sur un équipement isolé, puis faites valider le signal par la personne qui l’utilisera.