调用Lyft API请求行程时返回参数缺失错误排查求助

我之前对接Lyft API的时候也踩过这个一模一样的坑，明明传了坐标参数却被提示缺失，大概率是请求格式或者参数结构的问题，给你几个具体的排查和解决方向：

1. 检查请求体格式与Content-Type头 #

Lyft的v1/rides端点要求JSON格式的请求体，并且必须设置Content-Type: application/json请求头。如果你的请求是用form表单编码（比如application/x-www-form-urlencoded）来传参数，哪怕参数名写对了，API也会识别不到嵌套的origin字段。

错误的做法是把origin.lat作为扁平的表单键传递：

# 错误示例：表单格式的参数
form: {
  "ride_type": "lyft",
  "origin.lat": 37.7749,
  "origin.lng": -122.4194
}

正确的做法是用JSON嵌套结构，并且确保请求头正确：

# 正确示例：JSON请求体
{
  "ride_type": "lyft",
  "origin": {
    "lat": 37.7749,
    "lng": -122.4194
  },
  "destination": {
    "lat": 37.7898,
    "lng": -122.401
  }
}

2. 验证参数嵌套结构 #

很多人容易犯的错是把origin.lat和origin.lng作为顶级参数传递，而不是嵌套在origin对象里。Lyft API明确要求坐标参数放在origin和destination的子对象中，扁平的参数名（比如origin.lat）不会被API解析成嵌套结构。

3. 用curl快速测试 #

你可以先用curl发送一个标准请求来验证是否能成功，排除代码层面的问题：

curl -X POST "https://api.lyft.com/v1/rides" \
  -H "Authorization: Bearer YOUR_SERVER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ride_type": "lyft",
    "origin": {
      "lat": 37.7749,
      "lng": -122.4194
    },
    "destination": {
      "lat": 37.7898,
      "lng": -122.401
    }
  }'

如果这个curl请求能正常返回，那说明你的代码里肯定是请求格式或者头信息设置错了，重点检查代码里是否把请求体序列化成了JSON，以及Content-Type头是否正确设置。

4. 沙箱环境的特殊注意事项 #

沙箱环境的API规则和生产基本一致，但要确保你用的是沙箱对应的服务器令牌，并且测试坐标是Lyft沙箱支持的区域（比如美国旧金山的坐标，就是上面示例里的）。

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