Export dati AirTag e API

Export dei dati di posizione AirTag e integrazione via API

TagLogger esporta la cronologia degli AirTag in CSV o JSON e mette a disposizione un'API, così i dati arrivano nell'ERP, nel CMMS, nel TMS o nell'FSM che gestisce davvero le tue operazioni.

Cosa esporta TagLogger

  • Posizione attuale e storica di ogni AirTag collegato (lat/lon + data e ora)
  • Eventi di ingresso e uscita dai geofence con data e ora
  • Report sugli asset fermi: quelli che non si sono mossi in finestre di tempo configurabili
  • Metadati degli asset: nome, colore, categoria, team assegnato
  • Feed delle attività: registro completo degli eventi di ogni AirTag per qualsiasi intervallo scelto
  • Stato di batteria scarica e frequenza di segnalazione dell'AirTag

Formati di export

Il CSV è il formato di export più diffuso: è compatibile con Excel, Google Sheets e praticamente qualsiasi sistema aziendale. L'export CSV di TagLogger contiene, per ogni AirTag, colonne per data e ora, latitudine, longitudine, nome dell'asset ed eventuali eventi geofence associati a quella riga.

L'export JSON conserva l'intera struttura annidata dei dati, compresi i metadati dei geofence, la categoria dell'asset e i tipi di evento. Il JSON è utile per importare i dati direttamente da codice in script, data warehouse e integrazioni personalizzate.

Schemi di integrazione comuni

  • Snapshot CSV giornaliero: export programmato depositato in un'unità condivisa o in una cartella dell'ERP per la riconciliazione in batch
  • Report di audit settimanale: CSV degli asset fermi più un riepilogo delle attività per la revisione operativa
  • Webhook geofence: TagLogger invia un webhook HTTP quando si verifica un evento geofence, verso un endpoint dell'FSM o del TMS
  • Polling dell'API in tempo reale: dashboard personalizzate o strumenti di monitoraggio leggono i dati di posizione a intervalli regolari (di solito ogni 1–5 minuti)
  • Automazione basata sugli eventi: il webhook avvia i flussi a valle (avvisi Slack, apertura di ticket, rettifiche di inventario)

Sistemi da integrare: ERP, CMMS, TMS, FSM

I dati di posizione degli AirTag si collegano a quattro grandi categorie di software operativo. In tutti i casi l'integrazione ha una forma simile: un campo di geolocalizzazione nella scheda dell'asset, aggiornato a intervalli programmati o tramite webhook.

ERP: NetSuite, SAP, Oracle, Dynamics

Importa la cronologia delle posizioni AirTag come scheda asset personalizzata con un campo di geolocalizzazione, aggiornata con import CSV giornalieri o via API. Uso tipico: riconciliare la posizione fisica dell'asset con quella registrata nell'ERP.

CMMS: Maximo, eMaint, Fiix, UpKeep

Porta la posizione dell'AirTag nell'attributo di ubicazione dell'asset per supportare la pianificazione della manutenzione preventiva (trovare l'asset da manutenere senza girare il reparto) e nel collegamento tra ordine di lavoro e asset, così i tecnici vengono inviati alla posizione attuale.

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

Gli eventi geofence diventano aggiornamenti di stato delle spedizioni; la posizione di rimorchi e container alimenta i report di gestione del piazzale.

FSM: ServiceTitan, Housecall Pro, Jobber, FieldEdge

La posizione AirTag dei veicoli di servizio e delle valigette attrezzi orienta l'assegnazione degli interventi; gli eventi di arrivo nei geofence diventano notifiche automatiche ai clienti.

Nozioni di base sull'accesso via API

L'API di TagLogger dà accesso da codice agli stessi dati mostrati nell'interfaccia web. L'autenticazione si basa su chiavi API, con ambito limitato al singolo workspace. Endpoint comuni: elenco degli AirTag, ultima posizione di un AirTag, cronologia delle posizioni di un AirTag in un intervallo di tempo, elenco dei geofence e degli eventi geofence, lettura delle etichette dei tag definite nel workspace.

Per il polling ad alta frequenza, la maggior parte delle integrazioni si assesta su un intervallo di 1–5 minuti, in linea con la frequenza di aggiornamento effettiva della rete Dov'è (Find My). Interrogare più spesso non produce più dati, perché il collo di bottiglia è la frequenza dell'inoltro sottostante.

Per le integrazioni basate sugli eventi, le sottoscrizioni webhook sono più efficienti del polling. Iscriviti agli eventi di ingresso e uscita dai geofence e TagLogger invierà i dati al tuo endpoint nel momento stesso in cui si verifica un evento rilevante.

Guida rapida all'API AirTag: installa un SDK e fai la prima richiesta

TagLogger pubblica due SDK per la sua API dei dati AirTag, uno per TypeScript e JavaScript e uno per Python. Installane uno, crea una chiave del workspace in Settings → API Keys ed elenca i tuoi tag in poche righe. La guida rapida all'API spiega ogni passaggio e il riferimento dell'API elenca tutti gli endpoint.

  • TypeScript o JavaScript: npm install @taglogger/sdk (pacchetto npm). Funziona con Node 18 o versioni successive e include i propri tipi.
  • Python: pip install taglogger-sdk (pacchetto PyPI). Funziona con Python 3.9 o versioni successive, senza altre dipendenze, e si importa come taglogger_sdk.
  • Chiave API: imposta TAGLOGGER_API_KEY con una chiave del workspace che abbia l'ambito read:tags. La pagina Autenticazione spiega ambiti e header.
Elenca i primi 50 tag con l'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 "")

Leggi la guida rapida all'API

L'SDK TypeScript ha la stessa struttura: new TagLoggerClient({ apiKey }), poi client.tags.list({ limit: 50 }). Entrambi gli SDK coprono anche cronologia delle posizioni, geofence, webhook e verifica delle firme dei webhook.

Casi d'uso comuni di export e integrazione

  • Report di audit: export mensili o trimestrali che mostrano custodia e spostamenti degli asset per audit interni o esterni
  • Documentazione assicurativa: export CSV della cronologia delle posizioni per denunce di sinistro e casi di furto
  • Riconciliazione della fatturazione: confronto tra la posizione tracciata dell'asset e le date di noleggio o gli interventi a contratto
  • Automazione degli inventari: snapshot periodici della flotta nei sistemi di gestione dell'inventario
  • Registri di conformità: cronologia delle posizioni con data e ora per obblighi normativi (controlli sugli asset SOX, tracciamento dei dispositivi HIPAA)
  • Dashboard personalizzate: viste unificate dei dati AirTag insieme ad altri dati operativi (ERP, CRM, telemetria)
  • Pipeline di analisi: caricamento della cronologia AirTag in BigQuery/Snowflake/Redshift per analizzare l'utilizzo degli asset

Sicurezza di export e accesso via API

I dati di posizione degli AirTag hanno valore: rivelano dove si trovano e dove sono stati gli asset (e spesso le persone). Proteggi i dati esportati e quelli dell'API con controlli di accesso adeguati. Limita le chiavi API all'ambito di autorizzazione minimo necessario. Conserva le chiavi API in un gestore di segreti, non in file di configurazione in chiaro. Registra gli accessi all'API per l'audit.

Per gli export CSV condivisi all'esterno (con periti assicurativi, polizia, clienti in caso di contestazioni), condividi solo il periodo e gli asset necessari invece di un'estrazione dell'intera flotta. TagLogger supporta export per singolo asset e limitati nel tempo proprio per questo.

I clienti dei settori regolamentati (sanità, servizi finanziari) spesso fanno passare i dati di export e API di TagLogger dalla propria piattaforma di conformità invece di inviarli direttamente ai sistemi finali. È uno schema sensato, e il formato di export di TagLogger lo supporta.

Primi passi con export e API

Inizia dall'export CSV. Non richiede sviluppo, funziona con qualsiasi foglio di calcolo e copre la maggior parte dei casi di audit e riconciliazione. Gran parte dei clienti TagLogger usa il CSV per i primi 3–6 mesi e passa all'integrazione via API solo quando emerge un'esigenza di automazione precisa.

Per l'integrazione via API, il primo obiettivo pratico è il webhook geofence, perché fornisce segnali basati sugli eventi senza un'infrastruttura di polling. Un endpoint webhook e poche righe di logica possono automatizzare una parte consistente del flusso (avvisi Slack, apertura di ticket, aggiornamenti di stato) senza un'integrazione personalizzata completa.

L'integrazione completa con ERP o CMMS è un progetto più grande e di solito arriva dopo. Quando serve, gli schemi operativi del tracciamento con AirTag sono ormai chiari e l'integrazione punta a flussi di dati precisi invece che a “collegare tutto”.

Domande frequenti

Porta i dati AirTag nei sistemi che gestiscono le tue operazioni

Export CSV, export JSON, accesso via API e webhook: la cronologia delle posizioni AirTag alimenta ERP, CMMS, TMS, FSM e flussi personalizzati, senza silos di dati.