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

# 列出文件

> 列出你应用程序的文件。

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  你账户的 API 密钥。你可以在[账户设置](https://squarecloud.app/zh/account/security)中找到它。
</ParamField>

### 参数

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  应用程序的 ID。你可以在应用程序仪表盘的 URL 中找到它。
</ParamField>

<ParamField query="path" type="string" placeholder="Path to list" required>
  你想列出其文件的目录路径。默认为根目录。
</ParamField>

### 响应

<ResponseField name="status" type="string">
  指示调用是否成功。成功时为 `success`，否则为 `error`。
</ResponseField>

<ResponseField name="response" type="array">
  指定路径下的文件和目录列表。

  <Expandable title="展开对象">
    <ResponseField name="type" type="string">
      条目的类型。可以是 `file` 或 `directory`。
    </ResponseField>

    <ResponseField name="name" type="string">
      文件或目录的名称。
    </ResponseField>

    <ResponseField name="size" type="number">
      文件的大小，以字节为单位。对于目录，其值为 0。
    </ResponseField>

    <ResponseField name="lastModified" type="number">
      文件或目录的最后修改时间戳，以自纪元起的毫秒数表示。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
      "status": "success",
      "response": [
          {
              "type": "file",
              "name": ".env",
              "size": 86,
              "lastModified": 1676168978000
          },
          {
              "type": "file",
              "name": ".gitignore",
              "size": 8,
              "lastModified": 1675125328000
          },
          {
              "type": "file",
              "name": "index.js",
              "size": 614,
              "lastModified": 1676168350000
          },
          {
              "type": "file",
              "name": "squarecloud.app",
              "size": 65,
              "lastModified": 1676169188000
          },
          {
              "type": "directory",
              "name": "src",
              "lastModified": 1676155738000
          }
      ]
  }
  ```
</ResponseExample>