Geçmiş veri aktarımı

Bu kılavuzu tamamladığınızda programınız, bir cihazın geçmişte kaydettiği ölçümleri Proxus geçmiş veri deposuna gönderir. Bu ölçümler bir veri kaydediciden, bir CSV dosyasından ya da makinenin kendi belleğinden gelebilir. Aktarılan değerler cihazın canlı değerleriyle aynı yerde saklanır. Trendlerde, raporlarda ve Telemetry API sonuçlarında görünür.

Başlamadan önce

Şunlar gereklidir:

• Proxus'ta tanımlı, etkin ve çalışan bir Edge Gateway'e bağlı bir cihaz. Cihazın ID değerini (REST API'deki Oid) ve Erişim anahtarı değerini (cihaz sayfasında görünür) not edin.
• Edge Gateway'in HTTP portuna ağ erişimi. Varsayılan port 8083'tür ([Service] bölümünde Server-Port).
• Geçmiş veri aktarımının açık olması. Ürünle gelen yapılandırmada bu özellik kapalıdır. Nasıl açılacağı sonraki bölümde anlatılır.

Geçmiş veri aktarımını açın

Aşağıdaki anahtarları ayarlayın, ardından merkez sunucuyu ve Edge Gateway'leri yeniden başlatın:

Aktarım kapalıyken uç noktalar 503 döndürür.

Adım 1: Paket gönderin

POST http://<gateway>:8083/api/v1/devices/<device ID>/historical/batches
X-IoT-Token: <device token>
Idempotency-Key: lys-packer-04-2026-10-01-0001
Content-Type: application/json

{
  "records": [
    { "key": "Temperature", "time": "2026-10-01T06:00:00.000Z", "type": "Float", "value": 24.6, "unit": "°C" },
    { "key": "Speed",       "time": "2026-10-01T06:00:00.000Z", "type": "UShort", "value": 82, "unit": "rpm" },
    { "key": "Running",     "time": "2026-10-01T06:00:00.000Z", "type": "Bool", "value": true }
  ]
}

Gövdede bunların dışında bir alan varsa istek reddedilir. Gövdenin toplam boyutu en çok 256 KiB olabilir.

Idempotency-Key başlığı paketin kimliğidir. 8 ile 128 karakter arasında olmalı ve yalnızca harf, rakam, -, _ veya . içermelidir. Aynı anahtarla aynı gövdeyi yeniden göndermek güvenlidir: API ilk yanıtı tekrar döndürür. Aynı anahtarla farklı bir gövde gönderilirse istek reddedilir. Her paket için ayrı bir anahtar kullanın. Kaynak dosyanın adı ile paket numarasını birleştirmek iyi bir yöntemdir.

Adım 2: Yanıtı okuyun

Yeni bir paket 202 Accepted, daha önce gönderilmiş bir paket 200 yanıtı alır. Location başlığı paketin adresini verir.

{
  "jobId": "5b0e6a5c-6f4e-4a0e-9a59-3f8f0f8c2d11",
  "state": "Pending",
  "results": [
    { "index": 0, "state": "Pending" },
    { "index": 1, "state": "Pending" },
    { "index": 2, "state": "Rejected", "error": "InvalidTypeOrValue" }
  ],
  "storageDataset": "DeviceRawData"
}

Her kaydın sonucu ayrı olarak, gönderim sırasıyla döner. Reddedilen kayıtlar saklanmaz, diğer kayıtlar saklanır.

Adım 3: Paketi izleyin

GET http://<gateway>:8083/api/v1/devices/<device ID>/historical/batches/<jobId>
X-IoT-Token: <device token>

Yazma işleminden sonra kayıtların alabileceği durumlar şunlardır: Stored, Duplicate (o veri noktası ve zaman için aynı değer zaten saklı), Rejected veya Uncertain.

Paket bilgisi içermeyen yanıtlar

Python örneği

import time
import requests

GATEWAY = "http://localhost:8083"
DEVICE_ID = 69
DEVICE_TOKEN = "<the device's token>"


def send_batch(key, records):
    while True:
        response = requests.post(
            f"{GATEWAY}/api/v1/devices/{DEVICE_ID}/historical/batches",
            json={"records": records},
            headers={"X-IoT-Token": DEVICE_TOKEN, "Idempotency-Key": key},
            timeout=30,
        )
        if response.status_code in (429, 503):
            time.sleep(int(response.headers.get("Retry-After", "5")))
            continue
        response.raise_for_status()
        return response.json()


batch = [
    {"key": "Temperature", "time": "2026-10-01T06:00:00.000Z", "type": "Float", "value": 24.6, "unit": "°C"},
    {"key": "Temperature", "time": "2026-10-01T06:01:00.000Z", "type": "Float", "value": 24.9, "unit": "°C"},
]
job = send_batch("lys-packer-04-2026-10-01-0001", batch)
print(job["state"], [r["state"] for r in job["results"]])

Sonraki adımlar

• Telemetry API: aktarılan verileri kontrol edin.
• Trend çalışma alanı: aktarılan değerleri canlı değerlerle birlikte görüntüleyin.
• Ağ portları ve uç noktalar: Edge Gateway'in HTTP portunu ve diğer adresleri görün.