Anexos

Anexos

Anexos são arquivos (fotos, áudio, vídeo, documentos) vinculados a registros. Use esses endpoints para listar anexos e obter URLs de download temporárias.

GET /v1/attachments

Listar anexos, opcionalmente filtrados por registro.

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

# Anexos para um 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:

Resposta:

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

Obter uma URL de download assinada para um arquivo anexo. A URL é válida por 1 hora.

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

Resposta:

{
  "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 o campo url para baixar o arquivo diretamente. A URL expira após expires_in segundos (1 hora). Solicite uma nova URL quando necessário.

Baixar arquivos

# Obter a URL assinada
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')

# Baixar o arquivo
curl -o photo.jpg "$URL"