
媒体REST响应的字段会按上下文和权限呈现。公开查看需要的资料与编辑媒体所需信息并非完全相同;审核接口时应分别检查匿名view、授权edit及自定义字段,而不只确认媒体库菜单是否可见。
先列出业务需要公开什么
附件标题、替代文字和公开图片地址可能用于前端显示,内部文件路径、业务备注或受限资料则不应随意扩展到公开响应。默认媒体字段与插件新增字段需要分开盘点,不能根据原生文档推断所有扩展都使用相同权限。
核对上下文和字段定义
WordPress媒体接口文档为字段列出view、edit或embed等上下文,访问不同上下文还受认证和能力影响。返回字段减少不意味着文件本体已受保护,API字段控制与真实文件下载是两个独立范围,不能互相替代。

检查自定义注册的字段
开发者添加媒体元数据时,应核对show_in_rest配置、字段架构和权限回调,确保不该公开的数据不会因为接入前端而全部输出。读取函数能返回值,只能证明代码可取到数据,不证明当前调用者应该看到它。
以不同身份抽样响应
在测试环境用匿名和授权用户请求同一个可控附件,对照字段与错误响应。检查过滤参数、缓存以及批量列表是否保留同样边界。不要将真实客户私有附件作为公开测试样本,也不把包含敏感字段的响应粘到普通报告。
关键区别

view上下文:前端可见资料范围;还需看对象权限。
edit上下文:编辑所需信息;需要合适授权。
文件下载:真实资源访问;不能由API字段代替。
怎样确认处理到位
匿名及授权响应只包含约定字段,自定义元数据边界一致,列表和单项接口无意外泄露,文件访问另有独立检查。
容易误判的边界
接口字段减少、媒体库权限和文件下载控制是不同层。响应中不显示某个地址,不代表原始文件已禁止公开访问。
