# 使用临时能力链接读取文件

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

供外部模型提供方按签发链接读取一个文件的内容。

```text
GET https://api.moi.matrixorigin.cn/v5/catalog-files/{file_id}/content
```

## 调用前准备

先由有读取权限的身份签发模型链接，将返回的完整url设为MODEL_FILE_URL；到期时间使用expires_at。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl --fail-with-body -sS -X GET "$MODEL_FILE_URL" \
  -o "$OUTPUT_FILE"
```

:::::
:::::{tab-item} 参数说明

| 字段 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `file_id` | string | 是 | 路径中的文件ID，必须与签名绑定文件一致。 |
| `capability` | string | 是 | 唯一一次出现的查询参数，使用签发链接中的值。 |

直接访问签发url，无需产品PAT或工作区头。签名绑定工作区、文件及到期秒数。缺失/无效/过期/文件不可读/内容为空统一对外404；成功字节带no-store及no-referrer等响应头。

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```text
sample
```

:::::
:::::{tab-item} 字段说明

响应为字节流；消费并关闭流，检查读取/退出状态后使用文件。响应开始后失败可中断连接。

:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "ErrNotFound",
  "msg": "示例本地化错误"
}
```

:::::
:::::{tab-item} 字段说明

对外错误使用字符串code/msg，隐藏签名或存储内部原因。

:::::
::::::
:::::::
