调用AGC Connect API回复阿拉伯语评论失败 返回50010003参数错误

调用AGC Connect API执行阿拉伯语评论回复操作时返回参数错误，错误返回内容如下：

{
  "ret": {
    "rtnCode": 50010003,
    "rtnDesc": "param error"
  }
}

先后将请求中lang参数设置为ar_AE、ara_AE发起调用，均触发该报错，无法完成阿拉伯语评论回复操作。

• lang参数取值不符合接口规范：该接口不支持ISO 639-2标准的三字母语言编码，因此ara_AE属于无效取值；另外接口要求语言码和地区码之间使用短横杠-分隔，传入的带下划线的ar_AE同样无法被接口识别。
• 除lang参数外，若请求头编码配置错误、回复内容为空/含非法字符、评论ID传值错误，也会抛出50010003参数错误码。

• 修正lang参数取值：阿拉伯语场景下，不需要指定特定地区时直接传两字母编码ar即可；需要指定阿联酋地区时传入标准取值ar-AE，禁止使用三字母ara前缀、禁止用下划线做分隔符。
• 校验其余请求参数：
  • 确认传入的待回复评论ID属于当前操作的应用，且状态为可回复
  • 回复内容不能为空，阿拉伯语文本需使用UTF-8编码，不要携带不可见控制字符
  • 检查请求头Content-Type配置，需设置为application/json;charset=utf-8，避免服务端解析参数时出现编码识别异常
• 完成上述校验后重新发起调用，即可正常回复阿拉伯语评论。

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