调用Zendesk API时Guzzle返回422提示Email不能为空 Postman正常如何解决

问题根因 #

该报错是请求身份校验差异导致的，Zendesk API会根据请求方的身份权限动态调整字段校验规则：

• 当请求以客服/管理员身份（正确配置API Token鉴权）发起时，不需要传入email字段即可正常创建数据
• 当请求被识别为未认证的终端用户身份时，接口会强制要求提交email字段用来标识提交人身份，你看到的报错就是这个场景触发的

Postman请求正常是因为你配置了正确的鉴权信息，而Guzzle侧的鉴权配置大概率和Postman不一致，才会触发身份识别异常。

解决方案 #

按以下步骤排查即可解决：

1. 核对Guzzle鉴权配置，和Postman完全对齐
   Postman内的鉴权逻辑是用户名 = 你的Zendesk绑定邮箱 + /token，密码 = 你生成的Zendesk API Token，Guzzle的auth参数要完全对应，参考代码：

$client = new GuzzleHttp\Client();
$response = $client->request('POST', '你的Zendesk接口请求地址', [
    'auth' => ['xxx@yourdomain.com/token', '你的Zendesk API Token'],
    'json' => $yourPayload // 必须用json参数提交，不要用form_params
]);

2. 校验请求头格式
   确认Guzzle请求的Content-Type为application/json，如果用form_params提交表单格式的 payload，Zendesk会无法正确解析字段，也可能触发参数校验错误
3. 对比请求日志定位差异
   如果核对完配置仍然报错，可以开启Guzzle的请求日志，输出完整的请求头、请求体，和Postman导出的curl请求对比，就能快速定位到两者的差异点。

你之前尝试在不同位置传入email参数无效，是因为请求本身被识别为未认证身份，哪怕传了参数也可能因为权限校验规则不匹配无法通过，优先排查鉴权配置即可。

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