• data.id: UUID da conta
• data.name: Nome de exibição do perfil
• data.email: E-mail da conta
• data.account_type: Plano atual
• data.storage.used_bytes: Bytes armazenados
• data.storage.pending_bytes: Bytes reservados para uploads em andamento
• data.storage.quota_bytes: Máximo de bytes permitidos
• data.storage.available_bytes: Bytes restantes
• data.storage.usage_percentage: Uso de armazenamento em porcentagem
• data.stats.uploads_count: Total de uploads bem-sucedidos
• data.stats.downloads_count: Total de downloads bem-sucedidos
• data.stats.views_count: Total de eventos de visualização/stream
• data.stats.shares_count: Total de links de compartilhamento criados
• data.stats.files_count: Total de arquivos nas estatísticas
• data.stats.bandwidth_used_bytes: Largura de banda total transferida em bytes
• data.fair_use.daily_bandwidth_used_bytes: Contador Fair-Use atual do dia em bytes
• data.fair_use.full_speed_limit_bytes: A partir deste limite diário, o throttling começa
• data.fair_use.heavy_throttle_from_bytes: A partir deste limite diário, o throttling intenso começa
• data.fair_use.moderate_delay_ms: Atraso por chunk no throttling moderado
• data.fair_use.heavy_delay_ms: Atraso por chunk no throttling intenso
• data.fair_use.current_delay_ms: Atraso por chunk atualmente aplicado
• data.fair_use.current_state: full_speed|moderate|heavy

• Sempre vinculado ao proprietário. Nenhuma consulta entre contas possível.
• Todos os valores de largura de banda são em bytes.
• O throttling é baseado nos bytes diários de Fair-Use e no nível da conta.
• Throttling moderado começa quando daily_bandwidth_used_bytes >= full_speed_limit_bytes; throttling intenso quando >= heavy_throttle_from_bytes.

curl -X GET "https://cryptfiles.cloud/api/public/v1/account" \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

• data.items[].id
• data.items[].folder_id, original_file_id, reference_count
• data.items[].status, share_type, is_video, mime_type
• data.items[].file_size, file_size_encrypted, chunk_size, chunk_count
• data.items[].download_count, stream_count
• data.items[].metadata, thumbnail_path, thumbnail_nonce
• data.items[].created_at, updated_at, expires_at
• data.pagination.current_page, last_page, per_page, total

• Sem filtro de status, o padrão é status=available.

curl -X GET "https://cryptfiles.cloud/api/public/v1/files?per_page=50" \
  -H "Authorization: Bearer {token}"

• data.id
• data.folder_id, original_file_id, reference_count
• data.status, share_type, is_video, mime_type
• data.file_size, file_size_encrypted, chunk_size, chunk_count
• data.download_count, stream_count
• data.metadata, thumbnail_path, thumbnail_nonce
• data.created_at, updated_at, expires_at

• 404 se o arquivo não pertence ao proprietário do token.

curl -X GET "https://cryptfiles.cloud/api/public/v1/files/{file_id}" \
  -H "Authorization: Bearer {token}"

• Mesmo objeto de arquivo que em GET /files/{fileId}

• folder_id deve pertencer ao mesmo proprietário.
• O conteúdo do arquivo não é alterado por este endpoint.
• Se nenhum campo editável for enviado, o endpoint retorna 422.

curl -X PATCH "https://cryptfiles.cloud/api/public/v1/files/{file_id}" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"share_type":"private"}'

• success
• message

• 404 para recursos não visíveis/que não pertencem ao proprietário.

curl -X DELETE "https://cryptfiles.cloud/api/public/v1/files/{file_id}" \
  -H "Authorization: Bearer {token}"

• data.share_id, share_token, share_url
• data.expires_at, has_password
• message

• Endpoint exclusivo do proprietário.

curl -X POST "https://cryptfiles.cloud/api/public/v1/files/{file_id}/share" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"max_downloads":25}'

• data[].id, parent_folder_id, name, display_order
• data[].created_at, updated_at, deleted_at
• data[].file_count, subfolder_count, object_count
• data[].children[] (apenas com format=tree, mesmos campos recursivamente)

• Resultados são sempre vinculados ao proprietário.
• Valores inválidos de format retornam erro de validação 422.

curl -X GET "https://cryptfiles.cloud/api/public/v1/folders?format=tree" \
  -H "Authorization: Bearer {token}"

• data.folder.id, parent_folder_id, name, display_order
• data.folder.created_at, updated_at, deleted_at
• data.folder.file_count, subfolder_count, object_count
• data.breadcrumbs[] com os mesmos campos de pasta

• 404 para pastas que não pertencem ao proprietário.

curl -X GET "https://cryptfiles.cloud/api/public/v1/folders/{folder_id}" \
  -H "Authorization: Bearer {token}"

• data.id, parent_folder_id, name, display_order
• data.created_at, updated_at, deleted_at
• data.file_count, subfolder_count, object_count

• parent_folder_id deve pertencer à conta do proprietário.

curl -X POST "https://cryptfiles.cloud/api/public/v1/folders" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"name":"Projeto Alpha"}'

• data.id, parent_folder_id, name, display_order
• data.created_at, updated_at, deleted_at
• data.file_count, subfolder_count, object_count

• O destino de movimentações deve pertencer ao proprietário.
• Se nenhum campo editável for enviado, o endpoint retorna 422.
• Movimentações inválidas (para si mesmo/descendentes) retornam 422.

curl -X PATCH "https://cryptfiles.cloud/api/public/v1/folders/{folder_id}" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"display_order":3}'

• success
• message

• 404 para pastas que não pertencem ao proprietário.

curl -X DELETE "https://cryptfiles.cloud/api/public/v1/folders/{folder_id}" \
  -H "Authorization: Bearer {token}"

• data.query
• data.files[] com os mesmos campos de arquivo que GET /files/{fileId}
• data.folders[] com os mesmos campos de pasta que GET /folders/{folderId}.data.folder

• A busca é sempre limitada aos recursos do proprietário do token.

curl -X GET "https://cryptfiles.cloud/api/public/v1/search?q=video&type=files&limit=20" \
  -H "Authorization: Bearer {token}"