如何通过Postman调用Microsoft Dataverse Web API获取File列文件内容

前置条件 #

已获取到目标quotes表记录的唯一GUID值。 #

具体操作 #

1. 构造请求URL #

URL格式如下，将占位符替换为你实际的参数：
https://<你的Dataverse组织域名>/api/data/v9.2/quotes(<目标记录GUID>)/cra7f_ficheiropricing/$value

注意：必须在列名后加/$value后缀，否则接口返回的是文件元数据而非二进制内容；URL中的v9.2为Web API版本号，可替换为你实际使用的版本。

2. 配置Postman请求参数 #

• 请求方法选择GET
• 配置请求头：
  • 认证头：Authorization: Bearer <你的有效访问令牌>，和你之前查询quotes记录时用的令牌通用即可
  • 可选补充头：Accept: application/octet-stream，明确要求接口返回二进制流，避免自动转码

3. 发送请求获取内容 #

发送请求后，若状态码返回200即为成功，在Postman响应面板点击「保存响应到文件」即可导出完整文件，验证内容是否正确。 #

常见异常排查 #

• 返回404：检查URL拼写是否正确，确认记录GUID、列名拼写无误，不要直接在筛选集合的URL后拼接列路径，必须用单条记录的路由
• 返回403：检查当前账号的安全角色是否开通quotes表的读取权限，以及cra7f_ficheiropricing列的字段级读取权限
• 大文件（大于16MB）无法完整返回：需调用分块下载接口，小于16MB的文件直接使用上述方法即可

内容的提问来源于stack exchange，提问作者marz