TracePass
Loslegen
Pässe

Aktuelle Messwerte abrufen

Gibt den neuesten Messwert für jedes der akzeptierten Nutzungsdatenfelder aus Anhang XIII Punkt 4 zurück. Die Antwort ist { data: { <fieldKey>: LatestMeasurement | null } } — alle akzeptierten Schlüssel sind immer vorhanden; ein Schlüssel ist null, wenn für das betreffende Feld noch kein Messwert eingegangen ist. Eine LatestMeasurement enthält value, measuredAt sowie optional unit und externalId.

GET/api/v1/passports/{id}/measurements/latest
OpenAPI 3.1 herunterladen
GET/api/v1/passports/{id}/measurements/latest

Aktuelle Messwerte abrufen

Gibt den neuesten Messwert für jedes der akzeptierten Nutzungsdatenfelder aus Anhang XIII Punkt 4 zurück. Die Antwort ist { data: { <fieldKey>: LatestMeasurement | null } } — alle akzeptierten Schlüssel sind immer vorhanden; ein Schlüssel ist null, wenn für das betreffende Feld noch kein Messwert eingegangen ist. Eine LatestMeasurement enthält value, measuredAt sowie optional unit und externalId.

Dieser Endpoint spiegelt dieselben Werte wider, die die Pass-Ansicht im dynamischen Datenbereich anzeigt. dynamicDataAsOf im Pass ist das measuredAt des neuesten Messwerts über alle Felder hinweg — dieser Endpoint ermöglicht es Ihnen, den aktuellen Wert jedes Feldes und den Zeitpunkt der Messung abzurufen. Eine alternative Adressierungsform gibt es unter GET /api/v1/passports/by-serial/{serial}/measurements/latest mit derselben Antwortform. Bei nicht eindeutiger Seriennummer fügen Sie ?gtin=<gtin> zur Disambiguierung hinzu. Nur lesend; OAuth-Scope: passports:read.

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    Pass-ID.

Header

  • Authorizationerforderlich

    string

    Bearer <token> — entweder ein tp_ API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Anfrage

curl -sS \
  https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/measurements/latest \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "data": {
    "stateOfHealth": {
      "value": 96.4,
      "measuredAt": "2027-03-01T06:00:00Z",
      "externalId": "bms-7781-2027-03-01"
    },
    "numberOfFullEquivalentChargingCycles": {
      "value": 112,
      "measuredAt": "2027-03-01T06:00:00Z"
    },
    "currentStateOfCharge": null,
    "capacityFade": null,
    "powerFade": null,
    "stateOfCertifiedEnergy": null,
    "remainingCapacity": null,
    "remainingPowerCapability": null,
    "remainingRoundTripEfficiency": null,
    "evolutionOfSelfDischargeRate": null,
    "currentInternalResistancePack": null,
    "internalResistanceIncrease": null,
    "dynamicRatedCapacity": null,
    "dynamicPowerCapability": null,
    "dynamicInternalResistance": null,
    "dynamicEnergyRoundTripEfficiency": null,
    "dynamicExpectedLifetimeCycles": null,
    "numberOfChargingEvents": null,
    "negativeEvents": null,
    "temperatureConditionsHistorical": null
  }
}

Verwandte Endpoints