AirTag Datenexport & API
AirTag Standortdaten exportieren und per API integrieren
TagLogger exportiert den AirTag-Verlauf als CSV oder JSON und stellt eine API bereit. So landen die Daten im ERP, CMMS, TMS oder FSM, das den Betrieb tatsächlich steuert.
Was TagLogger exportiert
- Aktueller und historischer Standort für jeden verknüpften AirTag (Breite/Länge + Zeitstempel)
- Geofence-Ereignisse bei Einfahrt und Ausfahrt mit Zeitstempeln
- Berichte zu ruhenden Assets: Assets, die sich in einstellbaren Zeitfenstern nicht bewegt haben
- Asset-Metadaten: Name, Farbe, Kategorie, zugewiesenes Team
- Aktivitäts-Feed: vollständiges Ereignisprotokoll für jeden AirTag über jeden gewählten Zeitraum
- Hinweis auf niedrigen Batteriestand und Meldetakt des AirTags
Exportformate
CSV ist das gängigste Exportformat, kompatibel mit Excel, Google Sheets und praktisch jedem Unternehmenssystem. Der CSV-Export aus TagLogger enthält pro AirTag Spalten für Zeitstempel, Breitengrad, Längengrad, Asset-Name und alle Geofence-Ereignisse, die zu dieser Zeile gehören.
Der JSON-Export bewahrt die komplette verschachtelte Struktur der Daten, einschließlich Geofence-Metadaten, Asset-Kategorie und Ereignistypen. JSON eignet sich für die direkte programmatische Übernahme in Skripte, Data Warehouses und eigene Integrationen.
Gängige Integrationsmuster
- Täglicher CSV-Snapshot: geplanter Export in ein gemeinsames Laufwerk oder einen ERP-Ordner für den Abgleich im Batch
- Wöchentlicher Prüfbericht: CSV der ruhenden Assets plus Aktivitätsübersicht für die Durchsicht im Betriebsteam
- Geofence-Webhook: TagLogger löst bei einem Geofence-Ereignis einen HTTP-Webhook aus und sendet an einen FSM- oder TMS-Endpunkt
- Live-Abfrage per API: eigene Dashboards oder Monitoring-Tools holen Standortdaten in einem festen Takt (typischerweise alle 1–5 Minuten)
- Ereignisgesteuerte Automatisierung: ein Webhook stößt nachgelagerte Abläufe an (Slack-Benachrichtigungen, Ticket-Erstellung, Bestandskorrekturen)
Integrationsziele: ERP, CMMS, TMS, FSM
AirTag-Standortdaten lassen sich in vier große Kategorien betrieblicher Software einbinden. Die Form der Integration ist überall ähnlich: ein Geolokationsfeld am Asset-Datensatz, aktualisiert nach Zeitplan oder per Webhook.
ERP: NetSuite, SAP, Oracle, Dynamics
Übernehmen Sie den AirTag-Standortverlauf als eigenen Asset-Datensatz mit Geolokationsfeld, aktualisiert per täglichem CSV-Import oder API. Typischer Einsatz: den physischen Asset-Standort mit dem im ERP hinterlegten Standort abgleichen.
CMMS: Maximo, eMaint, Fiix, UpKeep
Speisen Sie den AirTag-Standort in das Standortattribut des Assets ein, um die Planung der vorbeugenden Instandhaltung (PM) zu unterstützen (Asset für die Wartung finden, ohne durch die Halle zu laufen), und in die Asset-Verknüpfung von Arbeitsaufträgen, damit Techniker zum aktuellen Standort geschickt werden.
TMS / WMS: Oracle TM, SAP TM, Blue Yonder, Manhattan
Geofence-Ereignisse werden als Statusaktualisierungen an Sendungen gebucht; Standorte von Anhängern und Containern fließen in Berichte des Yard-Managements ein.
FSM: ServiceTitan, Housecall Pro, Jobber, FieldEdge
Der AirTag-Standort von Servicefahrzeugen und Werkzeugkoffern fließt in Dispositionsentscheidungen ein; Geofence-Ankunftsereignisse werden als automatische Kundenbenachrichtigungen gesendet.
Grundlagen des API-Zugriffs
Die API von TagLogger bietet programmatischen Zugriff auf dieselben Daten, die die Web-Oberfläche zeigt. Die Authentifizierung läuft über API-Schlüssel, die pro Workspace gelten. Gängige Endpunkte: AirTags auflisten, letzten Standort eines AirTags abrufen, Standortverlauf eines AirTags über einen Zeitraum abrufen, Geofences und Geofence-Ereignisse auflisten und die im Workspace definierten Tag-Bezeichnungen lesen.
Bei häufiger Abfrage pendeln sich die meisten Integrationen auf einen Takt von 1–5 Minuten ein, passend zum praktischen Aktualisierungstakt des „Wo ist?“-Netzwerks (Find My). Häufigere Abfragen liefern nicht mehr Daten, weil der zugrunde liegende Weiterleitungstakt die Grenze setzt.
Bei ereignisgesteuerten Integrationen sind Webhook-Abonnements effizienter als Abfragen. Abonnieren Sie Geofence-Ereignisse bei Einfahrt und Ausfahrt, und TagLogger sendet an Ihren Endpunkt, sobald ein relevantes Ereignis eintritt.
AirTag API: Schnellstart mit SDK und erster Anfrage
TagLogger veröffentlicht zwei SDKs für seine AirTag-Daten-API, eines für TypeScript und JavaScript und eines für Python. Installieren Sie eines, erstellen Sie unter „Settings → API Keys“ einen Workspace-Schlüssel und listen Sie Ihre Tags in wenigen Zeilen auf. Der API-Schnellstart führt durch jeden Schritt, und die API-Referenz führt alle Endpunkte auf.
- TypeScript oder JavaScript: npm install @taglogger/sdk (npm-Paket). Läuft ab Node 18 und bringt eigene Typen mit.
- Python: pip install taglogger-sdk (PyPI-Paket). Läuft ab Python 3.9 ohne weitere Abhängigkeiten und wird als taglogger_sdk importiert.
- API-Schlüssel: Setzen Sie TAGLOGGER_API_KEY auf einen Workspace-Schlüssel mit dem Scope read:tags. Authentifizierung erklärt Scopes und Header.
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 "")Das TypeScript-SDK hat dieselbe Form: new TagLoggerClient({ apiKey }), dann client.tags.list({ limit: 50 }). Beide SDKs decken auch Standortverlauf, Geofences, Webhooks und die Prüfung von Webhook-Signaturen ab.
Gängige Anwendungsfälle für Export und Integration
- Prüfberichte: monatliche oder vierteljährliche Exporte, die Obhut und Bewegung von Assets für interne oder externe Audits belegen
- Versicherungsunterlagen: CSV-Export des Standortverlaufs für Schadensfälle und Diebstähle
- Abrechnungsabgleich: Standort getrackter Assets mit vereinbarten Mietzeiträumen oder Serviceterminen abgleichen
- Automatisierte Bestandszählung: regelmäßige Flotten-Snapshots in Bestandsverwaltungssysteme
- Compliance-Protokolle: Standortverlauf mit Zeitstempeln für regulatorische Anforderungen (SOX-Asset-Kontrollen, HIPAA-Geräte-Tracking)
- Eigene Dashboards: gemeinsame Sicht auf AirTag-Daten und andere Betriebsdaten (ERP, CRM, Telemetrie)
- Analyse-Pipelines: AirTag-Verlauf in BigQuery/Snowflake/Redshift laden, um die Asset-Auslastung auszuwerten
Sicherheitsaspekte bei Exporten und API-Zugriff
AirTag-Standortdaten sind wertvoll: Sie zeigen, wo Assets (und oft auch Menschen) sind und waren. Behandeln Sie Export- und API-Daten mit angemessenen Zugriffskontrollen. Beschränken Sie API-Schlüssel auf den minimal nötigen Berechtigungsumfang. Bewahren Sie API-Schlüssel in einem Secrets Manager auf, nicht in Klartext-Konfigurationen. Protokollieren Sie API-Zugriffe für Audits.
Bei CSV-Exporten, die Sie extern weitergeben (an Schadensregulierer, Polizei, Kunden bei Streitfällen), geben Sie nur das nötige Zeitfenster und die betroffenen Assets weiter statt eines Komplettabzugs der Flotte. TagLogger unterstützt genau dafür Exporte pro Asset und mit Zeitbegrenzung.
Kunden in regulierten Branchen (Gesundheitswesen, Finanzdienstleistungen) leiten Export- und API-Daten von TagLogger oft über ihre Compliance-Plattform statt direkt in die Zielsysteme. Das ist ein sinnvolles Muster, das das Exportformat von TagLogger unterstützt.
Erste Schritte mit Export und API
Beginnen Sie mit dem CSV-Export. Er erfordert keine Entwicklungsarbeit, funktioniert in jedem Tabellenkalkulationsprogramm und deckt die meisten Audit- und Abgleichfälle ab. Die meisten TagLogger-Kunden nutzen in den ersten 3–6 Monaten CSV und steigen erst auf die API-Integration um, wenn ein konkreter Automatisierungsbedarf entsteht.
Bei der API-Integration ist der Geofence-Webhook das praktische erste Ziel, weil er ereignisgesteuerte Signale liefert, ohne dass eine Abfrage-Infrastruktur nötig ist. Ein Webhook-Endpunkt plus ein paar Zeilen Logik automatisiert einen erheblichen Teil des Ablaufs (Slack-Benachrichtigungen, Ticket-Erstellung, Statusaktualisierungen), ohne vollständige Eigenintegration.
Eine vollständige ERP- oder CMMS-Integration ist ein größeres Projekt und kommt meist später. Wenn sie nötig wird, sind die betrieblichen Muster rund um das AirTag-Tracking gut verstanden, und die Integration zielt auf konkrete Datenflüsse statt auf „alles verbinden“.
Häufige Fragen
Bringen Sie AirTag-Daten in die Systeme, die Ihren Betrieb steuern
CSV-Export, JSON-Export, API-Zugriff und Webhooks: So speist der AirTag-Standortverlauf ERP, CMMS, TMS, FSM und eigene Abläufe, ohne Datensilos.
