Datensätze Auflisten und Filtern

GET /v1/records

Gibt eine paginierte Liste von Datensätzen in Ihrer Organisation zurück.

Abfrageparameter

Parameter	Typ	Standard	Beschreibung
`form_id`	string	--	Nach Formular-ID filtern
`project_id`	string	--	Nach Projekt-ID filtern
`since`	ISO 8601	--	Nur Datensätze, die nach diesem Zeitstempel aktualisiert wurden
`page`	integer	1	Seitennummer
`per_page`	integer	50	Elemente pro Seite (max 500)
`include_deleted`	boolean	false	Gelöschte Datensätze einbeziehen

Beispiel: Alle Datensätze auflisten

curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/records"

Beispiel: Nach Formular filtern

curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/records?form_id=frm_abc123"

Beispiel: Delta-Synchronisation (Änderungen seit)

Rufen Sie nur Datensätze ab, die seit Ihrer letzten Synchronisation geändert wurden:

curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/records?since=2026-02-15T00:00:00Z"

Antwort

{
  "ok": true,
  "data": [
    {
      "id": "rec_abc123",
      "type": "record",
      "form_id": "frm_xyz",
      "project_id": "prj_456",
      "form_version_id": "fv_789",
      "properties": {
        "inspector_name": "Jane Smith",
        "condition": "good",
        "notes": "All systems operational"
      },
      "geometry": null,
      "created_by": "user_id",
      "updated_by": "user_id",
      "created_at": "2026-02-15T14:30:00Z",
      "updated_at": "2026-02-15T16:45:00Z",
      "status": "active",
      "assigned_to": null,
      "workflow_state_id": null,
      "priority": null
    }
  ],
  "pagination": {
    "total": 1250,
    "page": 1,
    "per_page": 50,
    "total_pages": 25
  }
}

Hinweis: Der Listen-Endpoint lässt die Geometrie aus Leistungsgründen weg. Verwenden Sie GET /v1/records/:id für den vollständigen Datensatz mit Geometrie, oder verwenden Sie räumliche Abfragen zur Standortabfrage.

GET /v1/records/:id

Gibt einen einzelnen Datensatz mit vollständiger Geometrie zurück.

Beispiel

curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/records/rec_abc123"

Antwort

{
  "ok": true,
  "data": {
    "id": "rec_abc123",
    "type": "record",
    "form_id": "frm_xyz",
    "project_id": "prj_456",
    "properties": { "inspector_name": "Jane Smith" },
    "geometry": {
      "type": "Point",
      "coordinates": [-73.985, 40.758]
    },
    "created_at": "2026-02-15T14:30:00Z",
    "updated_at": "2026-02-15T16:45:00Z",
    "status": "active"
  }
}

Fehler: Nicht gefunden

{
  "ok": false,
  "error": {
    "code": "not_found",
    "message": "Record rec_abc123 not found."
  }
}