> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deepxl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Recuperação de Arquivos

> Recupere uploads originais e arquivos gerados a partir dos resultados da análise

Cada análise (detecção de fraude, parsing, verificação) armazena arquivos associados no armazenamento em nuvem. Use a API de Recuperação de Arquivos para baixar os uploads originais e ativos gerados, como mapas de calor.

## Recuperando um Arquivo

Cada resposta de análise inclui um array `files` com URLs de download. Use o nome do arquivo a partir da URL para recuperar o arquivo:

```bash theme={null}
curl https://api.deepxl.ai/v1/files/fd_42_bank_statement.pdf \
  -H "x-api-key: YOUR_API_KEY" \
  --output bank_statement.pdf
```

O endpoint retorna o arquivo como um stream binário com o cabeçalho `Content-Type` apropriado.

## Categorias de Arquivos

Os arquivos nas respostas de análise são categorizados de acordo com sua função:

| Categoria       | Serviço                     | Descrição                                               |
| --------------- | --------------------------- | ------------------------------------------------------- |
| `original_file` | Detecção de Fraude, Parsing | O arquivo que você enviou originalmente                 |
| `heatmap`       | Detecção de Fraude          | Mapa de calor gerado destacando a manipulação detectada |
| `id`            | Verificação                 | A imagem do documento de identidade                     |
| `face`          | Verificação                 | A imagem da selfie                                      |

## Encontrando URLs de Arquivo

As URLs de arquivo são incluídas em toda resposta de análise no array `files`:

```json theme={null}
{
  "files": [
    {
      "category": "original_file",
      "fileName": "bank_statement.pdf",
      "fileSize": 245678,
      "contentType": "application/pdf",
      "timestamp": 1735689600000,
      "timestampISO": "2025-01-01T00:00:00.000Z",
      "url": "https://api.deepxl.ai/v1/files/fd_42_bank_statement.pdf"
    },
    {
      "category": "heatmap",
      "fileName": "fd_42_heatmap_1.png",
      "fileSize": 45678,
      "contentType": "image/png",
      "timestamp": 1735689601000,
      "timestampISO": "2025-01-01T00:00:01.000Z",
      "url": "https://api.deepxl.ai/v1/files/fd_42_heatmap_1.png"
    }
  ]
}
```

## Controle de Acesso

Os arquivos têm escopo restrito à sua organização. Você só pode recuperar arquivos associados às suas próprias análises. Tentar acessar arquivos de outra organização retorna um `404`.