Twilio创建会话服务API调用报错:请求体缺少必填参数FriendlyName
Twilio 创建会话服务提示Missing required parameter FriendlyName的解决路径
这个报错本质是服务端没有在你发送的请求体里识别到对应参数,常见诱因和对应调整方案如下:
- 参数大小写不匹配是最高发的踩坑点
Twilio 原生REST API对POST参数名是严格大小写敏感的,接口要求的必填参数字段是FriendlyName(首字母F大写),而非你全程使用的小写开头的friendlyName。即使参数值完全正确,只要键名大小写不符,服务端就会判定参数缺失。 - 按照Content-Type的规则匹配请求体结构
- 如果使用
application/x-www-form-urlencoded格式发请求:直接将FriendlyName=你的会话服务名称以键值对形式拼接成表单内容发送,不要使用嵌套对象结构、不要对JSON做整体JSON.stringify、不要额外包裹data层级,这类不符合表单格式的嵌套内容会被服务端直接过滤为无效参数。 - 如果使用
application/json格式发请求:必须在请求头明确设置Content-Type: application/json,请求体直接做扁平化结构处理,即{"FriendlyName": "你的会话服务名称"},Twilio服务端不会主动解析嵌套层级内的字段。
- 如果使用
- 排除HTTP客户端的配置干扰
部分通用HTTP客户端(如axios)会自动把传入的data配置值作为请求体发送,如果你手动在请求体中再嵌套一层{data: {FriendlyName: "xxx"}},最终发出去的请求体会带冗余的嵌套结构,服务端无法读取到目标字段。
发送请求前可以通过工具预览实际发出的请求内容,确认最终请求体的最外层,确实存在键名严格为FriendlyName的有效键值对。
内容的提问来源于stack exchange,提问作者Udi Mazor
相关产品推荐
相关产品推荐

