Erste Schritte mit der Data API v1

Diese Anleitung bringt dich in wenigen Minuten von null zum erfolgreichen /v1/-API-Call. Du brauchst eine Unix-ähnliche Shell mit installiertem curl.

API-Key erstellen

Trassets richtet den Portal-Zugang für deine Organisation ein (keine öffentliche Registrierung). Melde dich unter portal.api.trassets.ai an, erzeuge selbst einen API-Key und speichere ihn sicher. Der Klartext-Key wird nur einmal angezeigt.

Deinen ersten Request stellen

Setze deinen Key als Umgebungsvariable und rufe technical_objects ab — eine Tabelle aus der Kategorie Property.

export TRASSETS_API_KEY="sk_live_…"
curl "https://api.trassets.ai/v1/property/technical_objects?limit=1" \
  -H "X-API-Key: $TRASSETS_API_KEY"

Die API liefert ein JSON-Objekt zurück: die Zeilen stehen in data, dazu count, next_cursor (null auf der letzten Seite) und total (null, außer du sendest include_total=true). Eine typische Antwort sieht so aus:

{
  "data": [
    {
      "technical_object_id": 5231,
      "property_id": 1622,
      "floor_area_id": null,
      "name": "Aufzug Hof",
      "type": "Aufzug",
      "built_date": "1998-06-01",
      "is_meter": false
    }
  ],
  "count": 1,
  "next_cursor": "eyJjb2wiOiAi…",
  "total": null
}

Wie technical_objects mit dem Rest von /v1/ verknüpft ist, steht in der v1 Datenmodell-Übersicht.

Geschafft! Du hast dich authentifiziert und deine erste Zeile Daten über einen /v1/-Endpunkt abgerufen.

Nächste Schritte

Lies Authentifizierung für Key-Management und Zugriffsstufen.
Prüfe die v1 Übersichtfür einen Überblick über die /v1/-Tabellen.
Lies die Response-Struktur für die Strukturregeln, denen jede /v1/-Response folgt.
Durchsuche die v1 Datenmodell-Seiten für die Feldreferenz jeder Tabelle.

Erste Schritte

Kernkonzepte

Anleitungen

Datenmodell

Erste Schritte mit der Data API v1