# Paginar arquivos do armazenamento em nuvem

Lista os arquivos do Cloud Storage, página por página.
- **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado.
- **Visibilidade**: **só são listados os arquivos cujo envio foi confirmado**: um arquivo com uma URL pré-assinada que nunca foi concluída não aparece. Membros sem a permissão de todos os dados veem apenas os arquivos que eles mesmos enviaram.
- **Filtragem**: `fileName` admite correspondência parcial; `tagIds` é uma correspondência OR; os resultados são ordenados do mais novo para o mais antigo e essa ordem não pode ser alterada.
- **Ressalva**: uma entrada de `tagInfo` pode ser null quando uma etiqueta foi excluída enquanto ainda estava vinculada ao arquivo.

Endpoint: POST /api/cloudstorage/file/page
Version: 2026-09-05

## Request fields (application/json):

  - `pageNo` (integer)
    Número da página atual, começando em 1. O padrão é 1.
    Example: 1

  - `pageSize` (integer)
    Número de itens por página. O padrão é 10.
    Example: 20

  - `fileName` (string)
    Palavra-chave do nome do arquivo para busca aproximada.
    Example: report

  - `tagIds` (array)
    Filtra os arquivos por IDs de etiqueta.
    Example: ["1800000000000101"]

  - `fileType` (integer)
    Filtro por tipo de arquivo: 0 = imagem, 1 = vídeo, 2 = aplicativo, 3 = áudio, 4 = documento, 5 = outro.
    Example: 0

  - `fileIds` (array)
    Filtra os arquivos por IDs de arquivo.
    Example: ["1800000000001001"]

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado. `0` significa sucesso; outros códigos indicam exceções.
    Example: 0

  - `msg` (string | null, required)
    Mensagem de erro.
    Example: null

  - `requestId` (string)
    ID da requisição da operação. Este campo pode estar presente quando a requisição passa pelo gateway da API.
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (object, required)

  - `data.current` (string, required)
    Example: 1

  - `data.pages` (string, required)
    Example: 7

  - `data.total` (string, required)
    Example: 128

  - `data.dataList` (array, required)

  - `data.dataList.id` (string)
    ID do arquivo do armazenamento em nuvem.
    Example: 1800000000001001

  - `data.dataList.fileName` (string)
    Nome do arquivo (sem extensão).
    Example: example

  - `data.dataList.fileExt` (string)
    Extensão do arquivo.
    Example: jpg

  - `data.dataList.fileSize` (string)
    Tamanho do arquivo em bytes.
    Example: 204800

  - `data.dataList.fileType` (integer)
    Tipo de arquivo: 0 = imagem, 1 = vídeo, 2 = aplicativo, 3 = áudio, 4 = documento, 5 = outro.
    Example: 0

  - `data.dataList.tagInfo` (array)
    Detalhes das etiquetas associadas ao arquivo.

  - `data.dataList.tagInfo.id` (string)
    ID da tag.
    Example: 1800000000000101

  - `data.dataList.tagInfo.tagSource` (string)
    Origem da etiqueta, por exemplo ENV, PROXY.
    Example: ENV

  - `data.dataList.tagInfo.tagName` (string)
    Nome da tag.
    Example: Invoice

  - `data.dataList.tagInfo.tagType` (string)
    Tipo de etiqueta: TAG ou GROUP.
    Example: TAG

  - `data.dataList.tagInfo.tagIcon` (string)
    Ícone da etiqueta.

  - `data.dataList.createDate` (string)
    Data de envio.

  - `data.dataList.updateDate` (string)
    Data de atualização.