Lyft Driver 司机端数据 API

Lyft, Inc. · 出行

Lyft Driver 是 Lyft 美国网约车网络面向司机的一端：司机用它上线、接收预付车费报价、完成接送驾导航，并看着收入在一周内不断累积。它是 Lyft 司机的主要工作工具，覆盖派单、评分、激励以及这份零工的收入侧。

作为数据源，该应用呈现了完整的司机资金闭环：钱包接口返回 available_balance 与即时提现资格，收入汇总拆出 gross_earnings、net_earnings 与 tip_amount，提现以 payout_transaction_id 标识，每个被接受的报价都带有 min_estimated_earnings / max_estimated_earnings 区间。薪酬服务、记账机器人与零工金融看板基于这些字段，按司机按周核对收入、小费与即时提现。

Lyft Driver 是 Lyft, Inc. 面向美国网约车司机的合作方应用：上线接单、接收预付车费报价、追踪收入并随时提现。地图、收入与钱包界面背后是一套司机数据集：会话令牌登录、带 driver_id 与 driver_rating 的资料卡、含 available_balance 的钱包余额、按 gross/net 汇总并单列 tip_amount 的收入报表、以 payout_transaction_id 标识的即时提现，以及每周提现历史。薪酬、记账与司机金融工具据此为零工司机核对收入、小费与提现。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

OAuth2 访问令牌
POST /v1/auth/driver-session osint
签发后续所有薪酬、收入、行程与提现调用所用的司机会话：access_token、refresh_token、token_type、expires_in 与 lyft_user_id。支持手机号、恢复码与通行密钥等授权类型。
认证方式：无（签发令牌）。后续调用发送 Authorization: Bearer access_token 并携带区域头。
- grant_type
- phone_number
- client_id
- access_token
- refresh_token
- token_type
- expires_in
- user_id
- lyft_user_id
```
POST /v1/auth/driver-session HTTP/1.1
Content-Type: application/x-www-form-urlencoded

grant_type=phone&phone_number=%2B14155550199&client_id=driver-app
```
```
{
  "access_token": "eyJhbGciOi...",
  "refresh_token": "d8f1c2a9...",
  "token_type": "Bearer",
  "expires_in": 2592000,
  "user_id": "123456789",
  "lyft_user_id": "123456789"
}
```
- 依据手机号登录与会话初始化流程重构。
- 令牌字段与每个需登录界面携带的凭证一致。
司机资料
GET /v1/partner/profile osint
加载已登录司机的资料卡：driver_id、姓名、手机号、driver_rating、停用状态，以及首页地图与收入界面所依赖的当前绑定 vehicle_id。
认证方式：会话登录调用签发的 Bearer access token，外加区域头
- driver_id
- lyft_user_id
- first_name
- last_name
- phone_number
- driver_rating
- overall_rating
- current_deactivation_status
- vehicle_id
```
GET /v1/partner/profile HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "driver_id": "d_9b0e12f4",
  "lyft_user_id": "123456789",
  "first_name": "Alex",
  "last_name": "Rivera",
  "phone_number": "+14155550199",
  "driver_rating": 4.92,
  "overall_rating": 4.92,
  "current_deactivation_status": "NONE",
  "vehicle_id": "veh_7c81f0e2"
}
```
- 依据首页地图的司机卡片与账户头部流程重构。
司机薪酬余额
GET /v1/partner-wallet/balance openbanking
读取收入栏背后的提现钱包：以 Money（amount、currency、exponent）表示的 available_balance、是否开启即时提现、每日提现上限与下次每周打款时间戳。
认证方式：会话登录调用签发的 Bearer access token
- available_balance
- availableBalance
- amount
- currency
- exponent
- instant_payout_enabled
- max_payouts_per_day
- next_payout_timestamp
- lyftDirectEnabled
```
GET /v1/partner-wallet/balance HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "available_balance": {
    "amount": 18450,
    "currency": "USD",
    "exponent": 2
  },
  "availableBalance": 184.50,
  "instant_payout_enabled": true,
  "max_payouts_per_day": 5,
  "next_payout_timestamp": 1759276800000,
  "lyftDirectEnabled": true
}
```
- 依据收入栏钱包与提现面板流程重构。

收入汇总

GET /v1/earnings/overview openfinance

返回收入首页展示的周期收入汇总：gross_earnings、net_earnings、tip_amount、estimated_earnings 与 ride_payout_total_amount，均为 Money 对象。

认证方式：会话登录调用签发的 Bearer access token

gross_earnings
net_earnings
tip_amount
estimated_earnings
ride_payout_total_amount
amount
currency
exponent

GET /v1/earnings/overview HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "gross_earnings": {"amount": 94200, "currency": "USD", "exponent": 2},
  "net_earnings": {"amount": 78150, "currency": "USD", "exponent": 2},
  "tip_amount": {"amount": 6300, "currency": "USD", "exponent": 2},
  "estimated_earnings": {"amount": 12000, "currency": "USD", "exponent": 2},
  "ride_payout_total_amount": {"amount": 71850, "currency": "USD", "exponent": 2}
}

依据收入首页的汇总数据重构。

司机收入动态

GET /v1/earnings/trip-feed openfinance

分页返回收入界面的逐程动态流：每个已完成行程的 ride_id、route_id、gross_earnings、tip_amount 与 payout_total。

认证方式：会话登录调用签发的 Bearer access token

ride_id
route_id
gross_earnings
tip_amount
payout_total
payout_type

GET /v1/earnings/trip-feed HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "sections": [
    {
      "ride_id": "rid_4e91aa12",
      "route_id": "rte_8c22b1d0",
      "gross_earnings": {"amount": 1850, "currency": "USD", "exponent": 2},
      "tip_amount": {"amount": 400, "currency": "USD", "exponent": 2},
      "payout_total": {"amount": 2250, "currency": "USD", "exponent": 2},
      "payout_type": "express_pay"
    }
  ]
}

依据收入界面的逐程动态流重构。

收入仪表板历史
GET /v1/earnings/dashboard openfinance
加载收入仪表板的历史标签页：Balance（available_balance）、Stats（gross/net）与驱动每周图表和提现按钮的 Modules。
认证方式：会话登录调用签发的 Bearer access token
- balance
- available_balance
- stats
- gross_earnings
- net_earnings
- modules
```
GET /v1/earnings/dashboard HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "balance": {
    "available_balance": {"amount": 18450, "currency": "USD", "exponent": 2}
  },
  "stats": {
    "gross_earnings": {"amount": 94200, "currency": "USD", "exponent": 2},
    "net_earnings": {"amount": 78150, "currency": "USD", "exponent": 2}
  },
  "modules": []
}
```
- 依据收入仪表板历史标签页重构。

每周收入明细

GET /v1/earnings/weekly openfinance

返回逐周收入明细：每周明细入口背后的 payout_period_ms、gross/net、小费与 weekly_payout。

认证方式：会话登录调用签发的 Bearer access token

payout_period_ms
gross_earnings
net_earnings
tip_amount
weekly_payout

GET /v1/earnings/weekly HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "stats": [
    {
      "payout_period_ms": 1758672000000,
      "gross_earnings": {"amount": 94200, "currency": "USD", "exponent": 2},
      "net_earnings": {"amount": 78150, "currency": "USD", "exponent": 2},
      "tip_amount": {"amount": 6300, "currency": "USD", "exponent": 2},
      "weekly_payout": {"amount": 78150, "currency": "USD", "exponent": 2}
    }
  ]
}

依据每周收入图表与明细入口流程重构。

提现资格
GET /v1/payouts/eligibility openbanking
检查当前是否允许即时提现，并返回提现面板渲染所用的可提现 line_items、available_balance 与每日上限。
认证方式：会话登录调用签发的 Bearer access token
- instant_payout_enabled
- available_balance
- max_payouts_per_day
- line_items
- payout_type
- amount
- currency
```
GET /v1/payouts/eligibility HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "instant_payout_enabled": true,
  "available_balance": {"amount": 18450, "currency": "USD", "exponent": 2},
  "max_payouts_per_day": 5,
  "line_items": [
    {"amount": {"amount": 18450, "currency": "USD", "exponent": 2}, "payout_type": "express_pay"}
  ]
}
```
- 依据即时提现资格面板重构。

Express Pay 即时提现

POST /v1/payouts/instant openbanking

对可提现的 available_balance 写入一笔即时提现，返回 payout_transaction_id、payout_type、payout_total 与 payout_time_ms。

认证方式：会话登录调用签发的 Bearer access token

amount
currency
exponent
payout_type
payout_transaction_id
payoutTransactionId
payoutType
payout_type_text
payout_total
payout_time_ms

POST /v1/payouts/instant HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "amount": {"amount": 18450, "currency": "USD", "exponent": 2},
  "payout_type": "express_pay"
}

{
  "payout_transaction_id": "po_6a11c4e8",
  "payoutTransactionId": "po_6a11c4e8",
  "payout_type": "express_pay",
  "payoutType": "express_pay",
  "payout_type_text": "Express Pay",
  "payout_total": {"amount": 18450, "currency": "USD", "exponent": 2},
  "payout_time_ms": 1759190400000
}

依据即时提现确认流程重构。

提现历史

GET /v1/payouts/history openbanking

以明细行记录列出历史即时提现与每周银行打款：payout_transaction_id、payout_type、payout_total、payout_time_ms 与 display_status。

认证方式：会话登录调用签发的 Bearer access token

payout_transaction_id
payout_type
payout_type_text
payout_total
payout_time_ms
payout_line_items
display_status

GET /v1/payouts/history HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "items": [
    {
      "payout_transaction_id": "po_6a11c4e8",
      "payout_type": "express_pay",
      "payout_type_text": "Express Pay",
      "payout_total": {"amount": 18450, "currency": "USD", "exponent": 2},
      "payout_time_ms": 1759190400000,
      "payout_line_items": [
        {"amount": {"amount": 18450, "currency": "USD", "exponent": 2}}
      ],
      "display_status": "COMPLETED"
    }
  ]
}

依据提现历史列表与详情界面重构。

Lyft Direct 借记账户
GET /v1/debit-card/account openbanking
读取绑定在司机名下的 Lyft Direct 借记账户：lyftDirectEnabled、账户状态（Active、InReview、CardSuspended、AccountBlocked 等）与卡钱包余额。
认证方式：会话登录调用签发的 Bearer access token
- lyftDirectEnabled
- status
- available_balance
- first_name
- last_name
```
GET /v1/debit-card/account HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "lyftDirectEnabled": true,
  "status": "Active",
  "available_balance": {"amount": 18450, "currency": "USD", "exponent": 2},
  "first_name": "Alex",
  "last_name": "Rivera"
}
```
- 依据借记卡管理与余额界面重构。
进入司机模式（上线）
POST /v1/dispatch/go-online opendata
让合作方上线进入派单状态：提交 GPS 与 vehicle_id，并带有末单与目的地筛选的同级写操作。
认证方式：会话登录调用签发的 Bearer access token
- latitude
- longitude
- vehicle_id
- online
- current_deactivation_status
```
POST /v1/dispatch/go-online HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "latitude": 37.7749,
  "longitude": -122.4194,
  "vehicle_id": "veh_7c81f0e2"
}
```
```
{
  "online": true,
  "vehicle_id": "veh_7c81f0e2",
  "current_deactivation_status": "NONE"
}
```
- 依据上线开关与派单入口流程重构。

接受行程

POST /v1/trips/accept opendata

接受一个预付车费报价，返回乘客卡片、destination_lat/lng 与预估收入区间。同级写操作覆盖到达、接驾、送驾、取消与评价乘客。

认证方式：会话登录调用签发的 Bearer access token

ride_id
route_id
offer_id
passenger_id
passenger_first_name
passenger_rating
destination_lat
destination_lng
min_estimated_earnings
max_estimated_earnings

POST /v1/trips/accept HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "ride_id": "rid_4e91aa12",
  "route_id": "rte_8c22b1d0",
  "offer_id": "off_11ab99c3",
  "latitude": 37.7749,
  "longitude": -122.4194
}

{
  "ride_id": "rid_4e91aa12",
  "route_id": "rte_8c22b1d0",
  "passenger_id": "pax_55c1d0aa",
  "passenger_first_name": "Jordan",
  "passenger_rating": 4.88,
  "destination_lat": 37.7849,
  "destination_lng": -122.4094,
  "min_estimated_earnings": {"amount": 1200, "currency": "USD", "exponent": 2},
  "max_estimated_earnings": {"amount": 1850, "currency": "USD", "exponent": 2}
}

依据预付报价接受卡片与行程状态流转重构。

行程中司机收入
GET /v1/trips/route-earnings openfinance
读取当前路线的行程中收入面板：送驾后展示的 route_payout_total_amount、route_payout_tips_amount 与 estimated_earnings。
认证方式：会话登录调用签发的 Bearer access token
- route_id
- ride_id
- route_payout_total_amount
- route_payout_tips_amount
- estimated_earnings
```
GET /v1/trips/route-earnings HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "route_id": "rte_8c22b1d0",
  "ride_id": "rid_4e91aa12",
  "route_payout_total_amount": {"amount": 2250, "currency": "USD", "exponent": 2},
  "route_payout_tips_amount": {"amount": 400, "currency": "USD", "exponent": 2},
  "estimated_earnings": {"amount": 1850, "currency": "USD", "exponent": 2}
}
```
- 依据送驾后展示的行程中收入面板重构。

激励活动

GET /v1/incentives/offers opendata

列出可选择的冲单挑战与连单奖励活动，带有每周计划器与激励地图渲染所用的 estimated_earnings 区间。

认证方式：会话登录调用签发的 Bearer access token

offer_id
estimated_earnings
min_estimated_earnings
max_estimated_earnings

GET /v1/incentives/offers HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "offers": [
    {
      "offer_id": "off_bonus_22",
      "estimated_earnings": {"amount": 2500, "currency": "USD", "exponent": 2},
      "min_estimated_earnings": {"amount": 2000, "currency": "USD", "exponent": 2},
      "max_estimated_earnings": {"amount": 3000, "currency": "USD", "exponent": 2}
    }
  ]
}

依据每周计划器与激励地图的活动流重构。

服务质量主页
GET /v1/quality/home opendata
加载评分统计所用的服务质量主页：driver_rating、overall_rating 与 qualifying_rating，并带有同级详情与反馈历史读取。
认证方式：会话登录调用签发的 Bearer access token
- driver_rating
- overall_rating
- qualifying_rating
```
GET /v1/quality/home HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "driver_rating": 4.92,
  "overall_rating": 4.92,
  "qualifying_rating": 4.80
}
```
- 依据评分与服务质量主页界面重构。
司机欠款
GET /v1/account/charges openfinance
读取司机未结费用：debt_amount 与 outstanding_balance_amount，结清前会阻止即时提现。
认证方式：会话登录调用签发的 Bearer access token
- debt_amount
- outstanding_balance_amount
- amount
- currency
- exponent
```
GET /v1/account/charges HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "debt_amount": {"amount": 2500, "currency": "USD", "exponent": 2},
  "outstanding_balance_amount": {"amount": 2500, "currency": "USD", "exponent": 2},
  "charges": [
    {"amount": {"amount": 2500, "currency": "USD", "exponent": 2}}
  ]
}
```
- 依据拦截提现的未结费用界面重构。

数据类别

身份
会话
钱包余额
收入汇总
收入动态
每周明细
Express Pay
提现历史
Lyft Direct
上线接单
行程报价
行程中收入
激励活动
评分
欠款

数据使用场景与案例

Express Pay 夜间对账
拉取 GET /v1/partner-wallet/balance（available_balance、instant_payout_enabled）与 GET /v1/payouts/history（payout_transaction_id、payout_total、payout_time_ms），将每笔即时提现与司机台账逐一核对。
每周收入与小费审计
组合 GET /v1/earnings/overview（gross_earnings、net_earnings、tip_amount）与 GET /v1/earnings/weekly、GET /v1/earnings/trip-feed（按 ride_id 的 payout_total），重建一周车费加小费的完整活动。
上线合规闸口
先读 GET /v1/partner/profile 的 current_deactivation_status 与 driver_rating，再携带 vehicle_id 调 POST /v1/dispatch/go-online，通过后才将合作方视为可派单。
预付报价收入叠加
在 POST /v1/trips/accept 时记录 min_estimated_earnings / max_estimated_earnings 区间，送驾结束后再与 GET /v1/trips/route-earnings（route_payout_total_amount、route_payout_tips_amount）对账。

常见问题

Lyft Driver 如何认证 API 调用？

会话登录调用在手机号、恢复码或通行密钥验证后签发 access_token 与 refresh_token 对。之后每次调用都发送 Authorization: Bearer access_token 并携带区域头。

哪些端点暴露司机收入与小费？

GET /v1/earnings/overview 返回 gross_earnings、net_earnings 与 tip_amount；GET /v1/earnings/trip-feed 按行程分页 payout_total；GET /v1/earnings/weekly 按 payout_period_ms 分组；GET /v1/trips/route-earnings 在行程中补充 route_payout_tips_amount。

即时提现如何运作？

GET /v1/payouts/eligibility 检查 instant_payout_enabled 与可提现的 line_items，GET /v1/partner-wallet/balance 读取 available_balance，随后 POST /v1/payouts/instant 写入提现并返回 payout_transaction_id。历史记录见 GET /v1/payouts/history。

接受行程会返回哪些数据？

POST /v1/trips/accept 接收 ride_id、route_id 与 offer_id，返回 passenger_first_name、passenger_rating、destination_lat/lng 以及 min_estimated_earnings / max_estimated_earnings 区间。到达、接驾、送驾与评价乘客是 /v1/trips/ 下的同级写操作。

与 Lyft Driver 相似的应用

Uber - Driver: Drive & Deliver — Uber 的司机端应用：接受叫车与配送订单、追踪收入并提现，是美国司机常与 Lyft Driver 同时运行的主要竞品。
DoorDash - Dasher — DoorDash 的 Dasher 配送端提供预付报酬与灵活排班的餐饮配送零工，是网约车司机常用的第二接单应用。
Careem Captain — Careem Captain 是 Careem 的司机端应用；Careem 是 Uber 旗下在中东与北非运营的网约车与配送平台。
Ola Driver App — Ola Driver 是印度本土网约车平台 Ola 的合作司机端，司机用它接单并查看每日收入。
Bolt Driver — Bolt Driver 是 Bolt 的司机端应用；Bolt 在欧洲与非洲运营网约车业务，以价格优势与 Uber 等平台竞争。
Grab Driver — Grab Driver 是 Grab 的合作司机端；Grab 是覆盖新加坡、马来西亚、印度尼西亚、越南等东南亚市场的网约车与配送平台。
Instacart Shopper — Instacart Shopper 让零工从业者代购并配送生鲜杂货赚取报酬，是对车辆要求更灵活的网约车替代选择。
Amazon Flex — Amazon Flex 让司机按预约时段配送亚马逊包裹与生鲜，适合更想送包裹而非载客的司机。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Lyft Driver 司机端数据 API

应用截图

API 端点一览

OAuth2 访问令牌

司机资料

司机薪酬余额

收入汇总

司机收入动态

收入仪表板历史

每周收入明细

提现资格

Express Pay 即时提现

提现历史

Lyft Direct 借记账户

进入司机模式（上线）

接受行程

行程中司机收入

激励活动

服务质量主页

司机欠款

数据类别

数据使用场景与案例

Express Pay 夜间对账

每周收入与小费审计

上线合规闸口

预付报价收入叠加

常见问题

与 Lyft Driver 相似的应用

更多出行类应用

Careem Captain

Ola Driver App

Porter - Logistics Service App

Porter Driver Partner App

相关主题

需要集成这个 App 的数据 API？

Lyft Driver 司机端数据 API

应用截图

API 端点一览

OAuth2 访问令牌

司机资料

司机薪酬余额

收入汇总

司机收入动态

收入仪表板历史

每周收入明细

提现资格

Express Pay 即时提现

提现历史

Lyft Direct 借记账户

进入司机模式（上线）

接受行程

行程中司机收入

激励活动

服务质量主页

司机欠款

数据类别

数据使用场景与案例

Express Pay 夜间对账

每周收入与小费审计

上线合规闸口

预付报价收入叠加

常见问题

相关应用

与 Lyft Driver 相似的应用

更多出行类应用

Careem Captain

Ola Driver App

Porter - Logistics Service App

Porter Driver Partner App

相关主题

需要集成这个 App 的数据 API？