调用PointClickCare API时Postman返回BAD_ENCODING错误排查

核心问题定位 #

你提到Postman控制台显示请求头缺失Content-Type: application/x-www-form-urlencoded，这几乎就是导致BAD_ENCODING错误的原因——该接口依赖这个头来解析请求体格式，缺失后服务端无法正确处理请求内容。

具体修复步骤 #

• 强制确认Content-Type头的发送：
  1. 切换到请求的「Headers」标签，手动添加Content-Type字段，值设为application/x-www-form-urlencoded，确保该字段未被禁用（无灰色禁用标识）。
  2. 即便你在「Body」标签选择了x-www-form-urlencoded格式，Postman偶尔会因缓存或配置异常自动跳过该头的添加，手动添加能避免这个问题。
• 规范请求体格式：
  确保grant_type=client_credentials是通过「Body」的x-www-form-urlencoded表单字段添加，不要直接在raw模式下编写字符串，防止手动编码出现格式错误。
• 验证Basic认证的正确性：
  Basic认证的凭证是客户端ID:客户端密钥经过Base64编码后的字符串，可手动用编码工具验证该字符串是否正确，替换Postman自动生成的认证头后重试，排除自动编码的异常。
• 重置Postman请求配置：
  若以上操作无效，导出当前请求后删除，重新导入；或清除Postman缓存（设置→General→Clear Cache），避免旧配置残留干扰。

验证步骤 #

发送请求后，再次查看Postman控制台的「Request Headers」区域，确认Content-Type已出现在实际发送的头列表中，再检查服务端返回结果。

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