Pièces jointes

Pièces jointes

Les pièces jointes sont des fichiers (photos, audio, vidéo, documents) liés aux enregistrements. Utilisez ces endpoints pour lister les pièces jointes et obtenir des URLs de téléchargement temporaires.

GET /v1/attachments

Lister les pièces jointes, optionnellement filtrées par enregistrement.

# Toutes les pièces jointes
curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/attachments"

# Pièces jointes pour un enregistrement spécifique
curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/attachments?record_id=rec_abc123"

Paramètres de requête :

Réponse :

{
  "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

Obtenir une URL de téléchargement signée pour un fichier joint. L'URL est valide pendant 1 heure.

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

Réponse :

{
  "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
  }
}

Utilisez le champ url pour télécharger le fichier directement. L'URL expire après expires_in secondes (1 heure). Demandez une nouvelle URL au besoin.

Télécharger des fichiers

# Obtenir l'URL signée
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')

# Télécharger le fichier
curl -o photo.jpg "$URL"