Aller au contenu principal

Intégrez un processus lié aux lieux, au-delà d’un point de terminaison

Les intégrations Alkax les plus solides conservent un identifiant de lieu stable, séparent les données privées du processus des données publiques du lieu et choisissent le niveau de confiance adapté à la décision.

Modèles courants​

Retrouver un lieu​

Utilisez la recherche Alkax lorsqu’un utilisateur ou opérateur doit sélectionner un lieu existant par nom, localité, Plus Code, coordonnées, catégorie ou proximité.

À conserver : l’identifiant du lieu Alkax et les champs nécessaires à l’affichage.
À revérifier : les données d’affichage modifiables lorsqu’elles doivent être à jour.

Enregistrer une destination manquante​

Permettez à un utilisateur autorisé de créer un lieu lorsque la recherche ne trouve aucune correspondance adaptée. Affichez les avertissements de doublon plutôt que de forcer automatiquement la création.

À conserver : l’identifiant de lieu renvoyé.
À éviter : traiter chaque adresse de livraison en texte libre comme un nouveau lieu public.

Vérifier ou enrichir​

Utilisez le point de terminaison partenaire approprié lorsqu’une décision opérationnelle nécessite un indice de qualité d’adresse ou de vérification plus solide.

À conserver : le résultat, son horodatage et tout identifiant de politique ou de version.
À éviter : interpréter un indice de confiance de la plateforme comme une preuve de propriété foncière ou de statut légal.

Confirmer avant l’expédition​

Utilisez Delivery Intelligence lorsque le destinataire doit approuver ou corriger la destination proposée avant la préparation de la livraison.

À conserver : l’identifiant de requête, la référence commerçant, l’instantané confirmé immuable, l’état du cycle de vie et l’identifiant d’événement.
À protéger : les coordonnées de contact du destinataire, le lien de confirmation, les instructions privées, les médias d’entrée, l’identifiant du commerçant et le secret de signature.

Ouvrir le guide Delivery Intelligence →

Your frontend → Your backend → Alkax API
                         ↘ Your webhook receiver

Le navigateur communique avec votre backend. Celui-ci conserve un identifiant de projet propre à l’environnement, appelle Alkax, applique les règles du tenant et renvoie uniquement les données nécessaires au navigateur.

Liste de contrôle pour une intégration en production​

  • Utilisez des identifiants de projet distincts pour Sandbox et Production.
  • Conservez les identifiants et secrets de webhook dans un gestionnaire de secrets.
  • Définissez des délais d’expiration et un nombre limité de nouvelles tentatives.
  • Utilisez des clés d’idempotence lorsque le processus l’exige.
  • Conservez les identifiants Alkax plutôt que de rechercher ensuite des correspondances par titre.
  • Dédupliquez les événements webhook avant d’appliquer leurs effets.
  • Masquez les données personnelles et les liens sécurisés dans les journaux.
  • Surveillez les quotas, les réponses 429, les échecs d’authentification et les webhooks en attente.
  • Testez les cas d’échec : doublons, corrections, expiration, révocation et nouvelles tentatives.

Après avoir choisi le modèle, consultez la référence API pour les schémas exacts.