Skip to main content

getCountersCount

Beschreibung:
Ruft den Zählerstand eines bestimmten Zählers oder Sensors zu einem angegebenen Zeitpunkt ab.
Dabei wird der zum angefragten UTC-Zeitpunkt passende verfügbare Zählerwert zurückgegeben.

Endpunkt: /api
Methode: POST

Parameter:

  • apikey (string) – API-Schlüssel des Benutzers, aus getApiKey()
  • SensorID (number) – Eindeutige Kennung des Sensors/Zählers, aus getSensors() oder getCounters()
  • UTC_TIMESTAMP (number) – Zeitpunkt im UTC-Timestamp-Format, für den der Zählerstand abgefragt werden soll

Beispielanfrage:

{
    "action": "getCounterCount",
    "apikey": "6641d282073d76b625987af5141d3e2a",
    "SensorID": "551911",
    "UTC_TIMESTAMP": "1739862041"
}

Beispiel mit cURL:

$body = @{
    action = "getCounterCount"
    apikey = "6641d282073d76b625987af5141d3e2a"
    SensorID = "551911"
    UTC_TIMESTAMP = "1739862041"
} | ConvertTo-Json -Compress

Invoke-RestMethod `
    -Uri "https://apiv2.smart-dog.eu/index.php" `
    -Method Post `
    -ContentType "application/json" `
    -Body $body

Beispielantwort:

{
    "CounterCount": "4592390",
    "TIMESTAMP_UTC": "1739833200.000000"
}

Beschreibung der Antwortparameter:

  • CounterCount (string):
    Zählerstand des angefragten Sensors oder Zählers zum ermittelten Zeitpunkt.

  • TIMESTAMP_UTC (string):
    UTC-Zeitstempel des zurückgegebenen Zählerstands.
    Dieser kann vom angefragten UTC_TIMESTAMP abweichen, wenn der nächstpassende verfügbare Messzeitpunkt verwendet wird.

Nähere Informationen zu Antwortformat und Fehlermeldungen:

Antwortformat und Fehler