AirTag Verilerini Dışa Aktarma ve API

AirTag Konum Verilerini Dışa Aktarma ve API Entegrasyonu

TagLogger AirTag geçmişini CSV veya JSON olarak dışa aktarır ve bir API sunar; böylece veriler operasyonu gerçekten yöneten ERP, CMMS, TMS veya FSM sistemine ulaşır.

TagLogger neleri dışa aktarır?

  • Bağlı her AirTag'in güncel ve geçmiş konumu (enlem/boylam + zaman damgası)
  • Zaman damgalı coğrafi sınır giriş ve çıkış olayları
  • Hareketsiz varlık raporları: yapılandırılabilir süreler boyunca hareket etmemiş varlıklar
  • Varlık meta verileri: isim, renk, kategori, atanan ekip
  • Etkinlik akışı: seçilen herhangi bir aralıkta her AirTag'in eksiksiz olay kaydı
  • Düşük pil durumu ve AirTag bildirim sıklığı

Dışa aktarma formatları

CSV en yaygın dışa aktarma formatıdır; Excel, Google Sheets ve neredeyse tüm işletme sistemleriyle uyumludur. TagLogger'ın CSV dışa aktarımı her AirTag için zaman damgası, enlem, boylam, varlık adı ve o satırla ilişkili coğrafi sınır olayları sütunlarını içerir.

JSON dışa aktarımı; coğrafi sınır meta verileri, varlık kategorisi ve olay türleri dahil verinin tüm iç içe yapısını korur. JSON, betiklere, veri ambarlarına ve özel entegrasyonlara doğrudan programatik aktarım için kullanışlıdır.

Yaygın entegrasyon yöntemleri

  • Günlük CSV anlık görüntüsü: toplu mutabakat için ortak bir sürücüye veya ERP klasörüne bırakılan zamanlanmış dışa aktarma
  • Haftalık denetim raporu: operasyon incelemesi için hareketsiz varlık CSV'si ve etkinlik özeti
  • Coğrafi sınır webhook'u: bir coğrafi sınır olayı gerçekleştiğinde TagLogger bir HTTP webhook'u tetikler ve bir FSM veya TMS uç noktasına gönderir
  • Canlı API sorgulama: özel paneller veya izleme araçları konum verilerini belirli aralıklarla çeker (genellikle 1–5 dakikada bir)
  • Olay güdümlü otomasyon: webhook sonraki iş akışını tetikler (Slack uyarıları, kayıt (ticket) oluşturma, envanter düzeltmeleri)

Entegrasyon hedefleri: ERP, CMMS, TMS, FSM

AirTag konum verisi dört geniş operasyonel yazılım kategorisine bağlanır. Entegrasyonun yapısı her birinde benzerdir: bir varlık kaydında, belirli aralıklarla veya webhook ile güncellenen bir coğrafi konum alanı.

ERP: NetSuite, SAP, Oracle, Dynamics

AirTag konum geçmişini, günlük CSV içe aktarmaları veya API ile güncellenen, coğrafi konum alanına sahip özel bir varlık kaydı olarak alın. Yaygın kullanım: fiziksel varlık konumunu ERP'de kayıtlı konumla karşılaştırarak mutabakat yapmak.

CMMS: Maximo, eMaint, Fiix, UpKeep

AirTag konumunu, önleyici bakım planlamasını desteklemek için (sahayı dolaşmadan bakım yapılacak varlığı bulmak) varlık konum özelliğine, teknisyenlerin güncel konuma yönlendirilmesi için de iş emri varlık bağlantısına aktarın.

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

Coğrafi sınır olayları sevkiyatlarda durum güncellemesi olarak gönderilir; römork ve konteyner konumu saha yönetimi raporlarına aktarılır.

FSM: ServiceTitan, Housecall Pro, Jobber, FieldEdge

Servis araçlarının ve alet takımlarının AirTag konumu iş atama kararlarına aktarılır; coğrafi sınır varış olayları otomatik müşteri bildirimleri olarak gönderilir.

API erişiminin temelleri

TagLogger'ın API'si, web arayüzünde gösterilen verilere programatik erişim sağlar. Kimlik doğrulama API anahtarına dayanır ve çalışma alanı bazında kapsamlandırılır. Yaygın uç noktalar: AirTag'leri listeleme, bir AirTag'in en son konumunu alma, bir AirTag'in belirli bir zaman aralığındaki konum geçmişini alma, coğrafi sınırları ve coğrafi sınır olaylarını listeleme ve çalışma alanında tanımlanmış etiket adlarını okuma.

Sık sorgulamada çoğu entegrasyon, Bul (Find My) ağının pratik güncelleme sıklığına uyan 1–5 dakikalık bir aralıkta karar kılar. Daha sık sorgulamak daha fazla veri üretmez, çünkü belirleyici adım alttaki aktarım sıklığıdır.

Olay güdümlü entegrasyonlarda webhook abonelikleri sorgulamadan daha verimlidir. Coğrafi sınır giriş/çıkış olaylarına abone olun; ilgili bir olay tetiklendiği anda TagLogger uç noktanıza gönderim yapsın.

AirTag API'si için hızlı başlangıç: bir SDK yükleyin ve ilk isteğinizi yapın

TagLogger, AirTag veri API'si için biri TypeScript ve JavaScript, diğeri Python için olmak üzere iki SDK yayımlar. Birini yükleyin, Ayarlar → API Anahtarları altında bir çalışma alanı anahtarı oluşturun ve birkaç satırla etiketlerinizi listeleyin. API hızlı başlangıç rehberi her adımı anlatır, API başvuru belgesi ise tüm uç noktaları listeler.

  • TypeScript veya JavaScript: npm install @taglogger/sdk (npm paketi). Node 18 veya üzerinde çalışır ve kendi tür tanımlarıyla gelir.
  • Python: pip install taglogger-sdk (PyPI paketi). Python 3.9 veya üzerinde başka hiçbir bağımlılık olmadan çalışır ve taglogger_sdk olarak içe aktarılır.
  • API anahtarı: TAGLOGGER_API_KEY değişkenine read:tags kapsamına sahip bir çalışma alanı anahtarı atayın. Kimlik doğrulama sayfası kapsamları ve başlıkları ele alır.
Python SDK ile ilk 50 etiketinizi listeleyin
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 "")

API hızlı başlangıç rehberini okuyun

TypeScript SDK'sı aynı yapıdadır: new TagLoggerClient({ apiKey }), ardından client.tags.list({ limit: 50 }). İki SDK da konum geçmişini, coğrafi sınırları, webhook'ları ve webhook imza doğrulamasını kapsar.

Yaygın dışa aktarma ve entegrasyon kullanım senaryoları

  • Denetim raporları: iç veya dış denetimler için varlıkların zimmetini ve hareketlerini gösteren aylık veya üç aylık dışa aktarmalar
  • Sigorta belgeleri: kayıp talepleri ve hırsızlık vakaları için konum geçmişinin CSV dışa aktarımı
  • Fatura mutabakatı: takip edilen varlık konumunu sözleşmedeki kiralama tarihleri veya servis ziyaretleriyle eşleştirme
  • Envanter sayımı otomasyonu: envanter yönetim sistemlerine periyodik filo anlık görüntüleri
  • Uyumluluk kayıtları: mevzuat şartları için zaman damgalı konum geçmişi (SOX varlık kontrolleri, HIPAA cihaz takibi)
  • Özel paneller: AirTag verisini diğer operasyonel verilerle (ERP, CRM, telemetri) birleştiren görünümler
  • Analitik veri hatları: varlık kullanım analizi için AirTag geçmişini BigQuery/Snowflake/Redshift'e yüklemek

Dışa aktarma ve API erişiminde güvenlik hususları

AirTag konum verisi değerlidir; varlıkların (ve çoğu zaman insanların) nerede olduğunu ve nerelerde bulunduğunu ortaya koyar. Dışa aktarılan ve API'den gelen verilere uygun erişim kontrolleri uygulayın. API anahtarlarını gereken en dar yetki kapsamıyla sınırlayın. API anahtarlarını düz metin yapılandırma dosyalarında değil, bir gizli bilgi yöneticisinde saklayın. Denetim için API erişimini kayıt altına alın.

Dışarıyla paylaşılan CSV dışa aktarımlarında (sigorta eksperleri, polis, anlaşmazlık yaşanan müşteriler), filonun tamamını aktarmak yerine yalnızca gerekli zaman aralığını ve varlıkları paylaşın. TagLogger tam da bunun için varlık bazında ve zaman aralığıyla sınırlı dışa aktarmayı destekler.

Düzenlemeye tabi sektörlerdeki (sağlık, finansal hizmetler) müşteriler, TagLogger dışa aktarma/API verilerini çoğu zaman doğrudan son sistemlere değil, uyumluluk platformları üzerinden aktarır. Bu, TagLogger'ın dışa aktarma formatının desteklediği makul bir yöntemdir.

Dışa aktarma ve API ile başlamak

CSV dışa aktarmayla başlayın. Hiçbir geliştirme işi gerektirmez, her tablo aracında çalışır ve denetim ile mutabakat kullanım senaryolarının çoğunu karşılar. TagLogger müşterilerinin çoğu ilk 3–6 ayında CSV kullanır ve ancak belirli bir otomasyon ihtiyacıyla karşılaştıklarında API entegrasyonuna geçer.

API entegrasyonunda pratik ilk hedef coğrafi sınır webhook'udur; çünkü sorgulama altyapısı gerektirmeden olay güdümlü sinyaller verir. Bir webhook uç noktası ve birkaç satırlık mantık, tam bir özel entegrasyona gerek kalmadan iş akışının önemli bir kısmını (Slack uyarıları, kayıt oluşturma, durum güncellemeleri) otomatikleştirebilir.

Tam ERP/CMMS entegrasyonu daha büyük bir projedir ve genellikle daha sonra gelir. Buna ihtiyaç duyulduğunda AirTag takibi etrafındaki operasyonel örüntüler iyice anlaşılmış olur ve entegrasyon "her şeyi bağlamak" yerine belirli veri akışlarını hedefler.

Sıkça sorulan sorular

AirTag verilerini operasyonunuzu yöneten sistemlere taşıyın

CSV dışa aktarma, JSON dışa aktarma, API erişimi ve webhook'lar; böylece AirTag konum geçmişi, veri siloları oluşmadan ERP, CMMS, TMS, FSM ve özel iş akışlarınızı besler.