如何在最新版WordPress REST API v2中获取raw字段值？

在新版WordPress里，raw字段默认只对拥有编辑/管理员权限的认证用户返回，未认证或者权限不够的请求只会拿到rendered值。你碰到的情况，大概率和权限传递或者OAuth1认证的配置有关，下面是具体的解决思路和排查步骤：

一、通过请求头参数获取raw数据 #

要拿到raw字段，你需要在API请求里加一个专属请求头，同时确保请求是已认证且权限足够的：

• 添加请求头：X-WP-Fields: raw
  这个头会告诉API只返回原始未处理的raw字段；要是想同时拿到raw和rendered，可以改成X-WP-Fields: raw,rendered

给你个curl请求的示例参考：

curl https://example.com/wp-json/wp/v2/media/32 \
  -H "Authorization: OAuth oauth_consumer_key='你的密钥', oauth_nonce='随机字符串', oauth_signature='生成的签名', oauth_signature_method='HMAC-SHA1', oauth_timestamp='时间戳', oauth_token='你的token'" \
  -H "X-WP-Fields: raw"

二、排查OAuth1认证的问题 #

你提到用了REST API OAuth1插件，怀疑认证有问题，可以从这几个点排查：

1. 确认用户权限：确保你用来做OAuth认证的账号，拥有编辑或者管理员权限——只有高权限用户才能获取raw字段
2. 检查认证参数：仔细核对请求里的OAuth签名、token、consumer key等参数，确保它们生成正确且没有遗漏，严格按照插件的文档流程来配置
3. 用自带认证方式测试：如果你的WordPress是5.6及以上版本，可以先用自带的应用密码做basic auth测试（记得在HTTPS环境下用）：

curl https://example.com/wp-json/wp/v2/media/32 \
  -u "你的用户名:你的应用密码" \
  -H "X-WP-Fields: raw"

如果这个请求能正常返回raw字段，那基本可以确定是OAuth1插件的配置或者签名生成环节出了问题

三、其他可能的排查方向 #

• 暂时禁用其他插件、切换到默认主题试试——有些主题或插件会修改REST API的响应结构，可能把raw字段过滤掉了
• 确保你的WordPress是最新版本，旧版本可能存在权限逻辑的bug

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