Anhänge

Anhänge

Anhänge sind Dateien (Fotos, Audio, Video, Dokumente), die mit Datensätzen verknüpft sind. Verwenden Sie diese Endpoints, um Anhänge aufzulisten und temporäre Download-URLs zu erhalten.

GET /v1/attachments

Anhänge auflisten, optional nach Datensatz gefiltert.

# Alle Anhänge
curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/attachments"

# Anhänge für einen bestimmten Datensatz
curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/attachments?record_id=rec_abc123"

Abfrageparameter:

Antwort:

{
  "ok": true,
  "data": [
    {
      "id": "att_001",
      "type": "attachment",
      "record_id": "rec_abc123",
      "file_name": "site_photo_001.jpg",
      "mime_type": "image/jpeg",
      "size_bytes": 2457600,
      "metadata": {
        "width": 4032,
        "height": 3024,
        "geotag": {"type": "Point", "coordinates": [-73.985, 40.758]}
      },
      "created_at": "2026-02-15T14:31:00Z",
      "updated_at": "2026-02-15T14:31:00Z"
    }
  ],
  "pagination": { "total": 5, "page": 1, "per_page": 50, "total_pages": 1 }
}

GET /v1/attachments/:id/url

Eine signierte Download-URL für eine Anhangdatei erhalten. Die URL ist 1 Stunde lang gültig.

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

Antwort:

{
  "ok": true,
  "data": {
    "id": "att_001",
    "file_name": "site_photo_001.jpg",
    "mime_type": "image/jpeg",
    "url": "https://your-project.supabase.co/storage/v1/object/sign/attachments/...",
    "expires_in": 3600
  }
}

Verwenden Sie das url-Feld, um die Datei direkt herunterzuladen. Die URL läuft nach expires_in Sekunden (1 Stunde) ab. Fordern Sie bei Bedarf eine neue URL an.

Dateien herunterladen

# Signierte URL abrufen
URL=$(curl -s -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/attachments/att_001/url" \
  | jq -r '.data.url')

# Datei herunterladen
curl -o photo.jpg "$URL"