Export de données et API AirTag

Export des données de localisation AirTag et intégration par API

TagLogger exporte l'historique AirTag en CSV ou JSON et propose une API : les données arrivent dans l'ERP, la GMAO, le TMS ou le logiciel de gestion des interventions (FSM) qui fait réellement tourner l'activité.

Ce que TagLogger exporte

  • La position actuelle et l'historique de chaque AirTag associé (lat/lon + horodatage)
  • Les événements d'entrée et de sortie de zone de géorepérage, horodatés
  • Les rapports d'équipements immobiles : ceux qui n'ont pas bougé depuis une durée configurable
  • Les métadonnées des équipements : nom, couleur, catégorie, équipe affectée
  • Le fil d'activité : le journal complet des événements de chaque AirTag sur n'importe quelle période
  • L'état de pile faible et le rythme des signalements de chaque AirTag

Formats d'export

Le CSV est le format d'export le plus courant : compatible avec Excel, Google Sheets et pratiquement tous les logiciels de gestion. L'export CSV de TagLogger comporte, pour chaque AirTag, des colonnes pour l'horodatage, la latitude, la longitude, le nom de l'équipement et les événements de géorepérage associés à chaque ligne.

L'export JSON conserve toute la structure imbriquée des données, y compris les métadonnées de géorepérage, la catégorie de l'équipement et les types d'événements. Le JSON est utile pour une ingestion programmatique directe dans des scripts, des entrepôts de données et des intégrations sur mesure.

Modes d'intégration courants

  • Instantané CSV quotidien : export planifié déposé dans un dossier partagé ou un répertoire de l'ERP pour un rapprochement par lot
  • Rapport d'audit hebdomadaire : CSV des équipements immobiles et synthèse d'activité pour la revue des opérations
  • Webhook de géorepérage : TagLogger déclenche un webhook HTTP lors d'un événement de géorepérage, vers un point de terminaison de votre FSM ou TMS
  • Interrogation de l'API en direct : des tableaux de bord ou outils de supervision sur mesure récupèrent les positions à intervalle régulier (généralement à intervalles de 1 à 5 minutes)
  • Automatisation pilotée par les événements : un webhook déclenche le processus en aval (alertes Slack, création de tickets, ajustements de stock)

Cibles d'intégration : ERP, GMAO, TMS, FSM

Les données de localisation AirTag s'intègrent à quatre grandes familles de logiciels d'exploitation. Le principe est le même dans chaque cas : un champ de géolocalisation dans la fiche de l'équipement, mis à jour selon un calendrier ou par webhook.

ERP : NetSuite, SAP, Oracle, Dynamics

Importez l'historique de localisation AirTag sous forme de fiche équipement personnalisée avec un champ de géolocalisation, mise à jour par import CSV quotidien ou via l'API. Usage courant : rapprocher la position physique d'un équipement de la position enregistrée dans l'ERP.

GMAO (CMMS) : Maximo, eMaint, Fiix, UpKeep

Alimentez l'attribut de localisation de l'équipement avec la position AirTag pour faciliter la planification de la maintenance préventive (localiser l'équipement sans arpenter les ateliers), et le lien équipement des ordres de travail pour envoyer les techniciens à la position actuelle.

TMS / WMS : Oracle TM, SAP TM, Blue Yonder, Manhattan

Les événements de géorepérage remontent comme mises à jour de statut des expéditions ; la position des remorques et des conteneurs alimente les rapports de gestion de cour.

FSM : ServiceTitan, Housecall Pro, Jobber, FieldEdge

La position AirTag des véhicules d'intervention et des caisses à outils éclaire les décisions d'affectation des interventions ; les événements d'arrivée dans une zone de géorepérage déclenchent des notifications automatiques aux clients.

Les bases de l'accès à l'API

L'API de TagLogger donne un accès programmatique aux mêmes données que l'interface web. L'authentification se fait par clé d'API, limitée à un espace de travail. Points de terminaison courants : lister les AirTag, obtenir la dernière position d'un AirTag, obtenir l'historique de localisation d'un AirTag sur une période, lister les zones de géorepérage et leurs événements, et lire les étiquettes de balises définies dans l'espace de travail.

Pour une interrogation fréquente, la plupart des intégrations se fixent sur un intervalle de 1 à 5 minutes, qui correspond au rythme réel de mise à jour du réseau Localiser (Find My). Interroger plus souvent ne produit pas plus de données, car c'est le rythme des relais qui limite le débit.

Pour les intégrations pilotées par les événements, les abonnements webhook sont plus efficaces que l'interrogation. Abonnez-vous aux événements d'entrée et de sortie de zone et TagLogger envoie les données à votre point de terminaison dès qu'un événement pertinent se produit.

Démarrage rapide avec l'API AirTag : installez un SDK et faites votre première requête

TagLogger publie deux SDK pour son API de données AirTag, l'un pour TypeScript et JavaScript, l'autre pour Python. Installez-en un, créez une clé d'espace de travail dans Paramètres → Clés API, et listez vos balises en quelques lignes. Le démarrage rapide de l'API détaille chaque étape, et la référence de l'API liste tous les points de terminaison.

  • TypeScript ou JavaScript : npm install @taglogger/sdk (paquet npm). Il fonctionne sur Node 18 ou version ultérieure et inclut ses propres types.
  • Python : pip install taglogger-sdk (paquet PyPI). Il fonctionne sur Python 3.9 ou version ultérieure, sans autre dépendance, et s'importe sous le nom taglogger_sdk.
  • Clé d'API : définissez TAGLOGGER_API_KEY avec une clé d'espace de travail disposant de la portée read:tags. Authentification détaille les portées et les en-têtes.
Lister vos 50 premières balises avec le SDK Python
import os
from taglogger_sdk import TagLoggerClient

client = TagLoggerClient(api_key=os.environ["TAGLOGGER_API_KEY"])
page = client.tags.list(limit=50)
for tag in page["data"]:
    print(tag["id"], tag["name"] or "")

Lire le démarrage rapide de l'API

Le SDK TypeScript a la même forme : new TagLoggerClient({ apiKey }), puis client.tags.list({ limit: 50 }). Les deux SDK couvrent aussi l'historique de localisation, les zones de géorepérage, les webhooks et la vérification de leur signature.

Usages courants de l'export et de l'intégration

  • Rapports d'audit : exports mensuels ou trimestriels montrant la garde et les déplacements des équipements pour les audits internes ou externes
  • Dossiers d'assurance : export CSV de l'historique de localisation pour les déclarations de sinistre et les cas de vol
  • Rapprochement de facturation : comparer la position des équipements suivis aux dates de location contractuelles ou aux interventions
  • Automatisation des inventaires : instantanés périodiques de la flotte dans les logiciels de gestion des stocks
  • Journaux de conformité : historique de localisation horodaté pour les exigences réglementaires (contrôles des actifs SOX, suivi des appareils HIPAA)
  • Tableaux de bord sur mesure : des vues unifiées des données AirTag et des autres données d'exploitation (ERP, CRM, télémétrie)
  • Chaînes d'analyse : charger l'historique AirTag dans BigQuery/Snowflake/Redshift pour analyser le taux d'utilisation des équipements

Sécurité des exports et de l'accès à l'API

Les données de localisation AirTag ont de la valeur : elles révèlent où se trouvent et sont passés les équipements (et souvent les personnes). Protégez les données d'export et d'API par des contrôles d'accès adaptés. Limitez les clés d'API à la portée minimale nécessaire. Stockez-les dans un gestionnaire de secrets, pas dans des fichiers de configuration en clair. Journalisez les accès à l'API pour l'audit.

Pour les exports CSV partagés à l'extérieur (experts d'assurance, police, clients en litige), ne partagez que la période et les équipements nécessaires, pas un export de toute la flotte. TagLogger permet précisément des exports par équipement et limités dans le temps pour cela.

Les clients des secteurs réglementés (santé, services financiers) font souvent transiter les données d'export ou d'API de TagLogger par leur plateforme de conformité plutôt que directement vers les systèmes finaux. C'est une pratique raisonnable que le format d'export de TagLogger prend en charge.

Bien démarrer avec l'export et l'API

Commencez par l'export CSV. Il ne demande aucun développement, fonctionne dans n'importe quel tableur et couvre la plupart des besoins d'audit et de rapprochement. La plupart des clients TagLogger utilisent le CSV pendant leurs 3 à 6 premiers mois et ne passent à l'intégration par API qu'au moment où un besoin d'automatisation précis apparaît.

Pour l'intégration par API, la première cible pratique est le webhook de géorepérage : il fournit des signaux pilotés par les événements sans infrastructure d'interrogation. Un point de terminaison webhook et quelques lignes de logique suffisent à automatiser une bonne part du processus (alertes Slack, création de tickets, mises à jour de statut) sans intégration complète sur mesure.

L'intégration complète à un ERP ou une GMAO est un projet plus lourd, qui vient généralement plus tard. Le moment venu, les pratiques opérationnelles autour du suivi par AirTag sont bien comprises, et l'intégration cible des flux de données précis plutôt que de « tout connecter ».

Questions fréquentes

Faites entrer les données AirTag dans les systèmes qui pilotent votre activité

Export CSV, export JSON, accès API et webhooks : l'historique de localisation AirTag alimente vos ERP, GMAO, TMS, FSM et processus sur mesure, sans silos de données.