Zum Inhalt springen
Pässe

The published versions of a unit's passport, newest first

Scope: readSiehe auch:Authentifizierung ·Fehler ·Paginierung ·Ratenlimits
GET
/batteries/{batteryId}/passport/versions

Any member. With at, only versions published at or before that instant: the first item is the version that was valid then (history by date for the portal, with every tier).

Autorisierung

apiKey
headerAutorisierungBearer <Token>

Organisation API key sent as Authorization: Bearer bp_live_… (ADR-017). Accepted only by the operations that list this scheme, with the scope in their x-api-key-scope.

Pfad-Parameter

batteryId*string
Formatuuid

Query-Parameter

limit?integer

Maximum number of items to return.

Bereich1 <= value <= 200
Standard50
cursor?string

Opaque cursor from a previous page's next_cursor.

Länge1 <= length <= 512
at?string
Formatdate-time

Antwort-Body

A page of versions.

application/json
  1. response
items*array<>
next_cursor*|

Cursor for the next page, or null when this is the last page.

Beispielanfrage
curl -X GET 'https://example.com/api/v1/batteries/497f6eca-6276-4993-bfeb-53cbbbba6f08/passport/versions'
Beispielantwort
{  "items": [    {      "batterypass_v2_issue_count": 0,      "batterypass_v2_valid": true,      "canonical_hash": "string",      "key_id": "string",      "public_hash": "string",      "published_at": "2019-08-24T14:15:22Z",      "published_by": "9ac9eee7-2153-423d-b22d-04e12679154a",      "published_by_name": "string",      "reason": "string",      "registry_version": "string",      "valid_until": "2019-08-24T14:15:22Z",      "version_no": 1    }  ],  "next_cursor": "string"}