Adjuntos

Archivos adjuntos

Los archivos adjuntos son archivos (fotos, audio, video, documentos) vinculados a registros. Use estos endpoints para listar adjuntos y obtener URLs de descarga temporales.

GET /v1/attachments

Listar adjuntos, opcionalmente filtrados por registro.

# Todos los adjuntos
curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/attachments"

# Adjuntos para un registro específico
curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/attachments?record_id=rec_abc123"

Parámetros de consulta:

Respuesta:

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

Obtener una URL de descarga firmada para un archivo adjunto. La URL es válida durante 1 hora.

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

Respuesta:

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

Use el campo url para descargar el archivo directamente. La URL expira después de expires_in segundos (1 hora). Solicite una nueva URL cuando sea necesario.

Descargar archivos

# Obtener la URL firmada
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')

# Descargar el archivo
curl -o photo.jpg "$URL"